Menu
FirestoreAdminSource connects google_cloud_firestore for server-side Dart applications to a SourceList.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | instantiating-firestore-admin-source |
| description | FirestoreAdminSource connects google_cloud_firestore for server-side Dart applications to a SourceList. |
| metadata | {"last_modified":"Wed, 22 Jul 2026 15:00:00 GMT"} |
pkg:data_layer_firestore_admin provides a FirestoreAdminSource class which implements the Source interface for server-side Dart applications using pkg:google_cloud_firestore.
Instantiate FirestoreAdminSource within a SourceList:
import 'package:data_layer_firestore_admin/data_layer_firestore_admin.dart';
import 'package:google_cloud_firestore/google_cloud_firestore.dart';
final firestore = Firestore(settings: const Settings(projectId: 'my-project'));
final adminSource = FirestoreAdminSource<MyModel>(
firestore,
bindings: MyModel.bindings,
collectionName: 'my_collection',
onCreateServerTimestampFields: ['createdAt'],
onUpdateServerTimestampFields: ['updatedAt'],
);
Note: google_cloud_firestore is designed for server-side Dart and does not support real-time stream watching (watch, watchList, watchByIds). Calling watch methods will throw an UnimplementedError.
Understand how sources declare operation capabilities via supportedOperations and how SourceList respects them.
FirestoreSource seamlessly connects Cloud Firestore streams to a SourceList.
Perform untyped Firestore document merges using the raw method on Firestore sources.
Cached data is mapped uniquely per request hash (RequestDetails with specific filter and pagination), supporting a powerful request-based caching behavior.
The SourceList class manages the delegation of read/write attempts to various configured Sources, with a read-thru cache system prioritizing local Sources.
ConnectivityPlusStream provides a stream of network statuses based on connectivity_plus so DefaultRetryPolicy can intelligently manage failed Operations.