[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-firebase-firebase-data-connect":3,"mdc--gvcl80-key":38,"related-org-firebase-firebase-data-connect":1699,"related-repo-firebase-firebase-data-connect":1885},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":27,"repoUrl":28,"updatedAt":29,"license":30,"forks":31,"topics":32,"repo":33,"sourceUrl":36,"mdContent":37},"firebase-data-connect","build backends with Firebase Data Connect","Builds and deploys Firebase SQL Connect (aka Firebase Data Connect) backends with PostgreSQL securely. Use when designing schemas with tables and relations, writing authorized queries and mutations, configuring real-time data updates, or generating type-safe SDKs. Use when you need a relational database with Firebase, or when the user mentions SQL Connect or Data Connect.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"firebase","Firebase (Google)","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Ffirebase.png",[12,16,19,22,25],{"name":13,"slug":14,"type":15},"Backend","backend","tag",{"name":17,"slug":18,"type":15},"GraphQL","graphql",{"name":20,"slug":21,"type":15},"Database","database",{"name":23,"slug":24,"type":15},"PostgreSQL","postgresql",{"name":26,"slug":8,"type":15},"Firebase",376,"https:\u002F\u002Fgithub.com\u002Ffirebase\u002Fagent-skills","2026-04-06T18:12:07.681031",null,75,[],{"repoUrl":28,"stars":27,"forks":31,"topics":34,"description":35},[],"Agent Skills for Firebase","https:\u002F\u002Fgithub.com\u002Ffirebase\u002Fagent-skills\u002Ftree\u002FHEAD\u002Fskills\u002Ffirebase-data-connect-basics","---\nname: firebase-data-connect\ndescription: Builds and deploys Firebase SQL Connect (aka Firebase Data Connect) backends with PostgreSQL securely. Use when designing schemas with tables and relations, writing authorized queries and mutations, configuring real-time data updates, or generating type-safe SDKs. Use when you need a relational database with Firebase, or when the user mentions SQL Connect or Data Connect.\n---\n\n# Firebase SQL Connect\n\nFirebase SQL Connect is a relational database service using Cloud SQL for\nPostgreSQL with GraphQL schema, auto-generated queries\u002Fmutations, and type-safe\nSDKs.\n\n> [!NOTE] **Product Rename**: Firebase Data Connect was renamed to **Firebase\n> SQL Connect**. All instructions, references, and examples in this skill\n> repository referring to \"Data Connect\" or \"Firebase Data Connect\" apply to\n> \"SQL Connect\" and \"Firebase SQL Connect\" as well.\n\n## Project Structure\n\n```text\ndataconnect\u002F\n├── dataconnect.yaml      # Service configuration\n├── seed_data.gql         # LOCAL ONLY — prototype\u002Ftest data\n├── schema\u002F\n│   └── schema.gql        # Data model (types with @table)\n└── connector\u002F\n    ├── connector.yaml    # Connector config + SDK generation\n    ├── queries.gql       # Queries\n    └── mutations.gql     # Mutations\n```\n\n## Key Tools for Validation\n\nRely on these two mechanisms to ensure project correctness:\n\n1. **Review GraphQL Schema**: Both user-defined and generated extensions (in\n   `.dataconnect\u002Fschema\u002Fmain\u002F`).\n1. **Validate Operations**: Run\n   `npx -y firebase-tools@latest dataconnect:compile` against the schema.\n\n## Operation Strategies: GraphQL vs. Native SQL\n\nAlways default to **Native GraphQL**. **Native SQL lacks type safety** and\nbypasses schema-enforced structures. Only use **Native SQL** when the user\nexplicitly requests it or when the task requires advanced database features.\n\n| Strategy                     | When to use                                                                                                            | Implementation                                                                                                        |\n| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |\n| **Native GraphQL** (Default) | Almost all use cases. Standard CRUD, basic filtering\u002Fsorting, simple relational joins. Requires full type safety.      | Auto-generated fields (`movie_insert`, `movies`). Strong typing and schema enforcement.                               |\n| **Native SQL** (Advanced)    | PostgreSQL extensions (e.g., PostGIS), window functions (`RANK()`), complex aggregations, or highly tuned sub-queries. | Raw SQL string literals via `_select`, `_execute`, etc. Requires strict positional parameters (`$1`). No type safety. |\n\n## Development Workflow\n\nFollow this strict workflow to build your application. You **must** read the\nlinked reference files for each step to understand the syntax and available\nfeatures.\n\n### 1. Define Data Model (`schema\u002Fschema.gql`)\n\nDefine your GraphQL types, tables, and relationships (which map to a Postgres\nschema).\n\n> **Read [reference\u002Fschema.md](reference\u002Fschema.md)** for:\n>\n> - `@table`, `@col`, `@default`\n> - Relationships (`@ref`, one-to-many, many-to-many)\n> - Data types (UUID, Vector, JSON, etc.)\n\n### 2. Define Authorized Operations (`connector\u002Fqueries.gql`, `connector\u002Fmutations.gql`)\n\nWrite the queries and mutations your client will use, including authorization\nlogic. SQL Connect is secure by default.\n\n> **Read [reference\u002Foperations.md](reference\u002Foperations.md)** for:\n>\n> - **Queries**: Filtering (`where`), Ordering (`orderBy`), Pagination\n>   (`limit`\u002F`offset`).\n> - **Mutations**: Create (`_insert`), Update (`_update`), Delete (`_delete`).\n> - **Upserts**: Use `_upsert` to \"insert or update\" records (CRITICAL for user\n>   profiles).\n> - **Transactions**: Use `@transaction` for multi-step atomic operations. Use\n>   `_expr: \"response.\u003CprevStep>\"` to pass data between steps.\n>\n> **Read [reference\u002Fsecurity.md](reference\u002Fsecurity.md)** for authorization:\n>\n> - `@auth(level: ...)` for PUBLIC, USER, or NO_ACCESS.\n> - `@check` and `@redact` for row-level security and validation.\n>\n> **Read [reference\u002Frealtime.md](reference\u002Frealtime.md)** for real-time\n> subscriptions:\n>\n> - `@refresh` directive for time-based polling and event-driven updates.\n> - CEL conditions to scope refresh triggers precisely.\n>\n> **Read [reference\u002Fnative_sql.md](reference\u002Fnative_sql.md)** for Native SQL\n> operations:\n>\n> - Embedding raw SQL with `_select`, `_selectFirst`, `_execute`\n> - Strict rules for positional parameters (`$1`, `$2`), quoting, and CTEs\n> - Advanced PostgreSQL features (PostGIS, Window Functions)\n\n### 3. Use type-safe SDK in your apps\n\nGenerate type-safe code for your client platform.\n\nConfigure SDK generation in `connector.yaml`:\n\n```yaml\nconnectorId: my-connector\ngenerate:\n  javascriptSdk:\n    outputDir: \"..\u002Fweb-app\u002Fsrc\u002Flib\u002Fdataconnect\"\n    package: \"@movie-app\u002Fdataconnect\"\n  kotlinSdk:\n    outputDir: \"..\u002Fandroid-app\u002Fapp\u002Fsrc\u002Fmain\u002Fkotlin\u002Fcom\u002Fexample\u002Fdataconnect\"\n    package: \"com.example.dataconnect\"\n  swiftSdk:\n    outputDir: \"..\u002Fios-app\u002FDataConnect\"\n```\n\nGenerate SDKs:\n\n```bash\nnpx -y firebase-tools@latest dataconnect:sdk:generate\n```\n\nFor platform-specific instructions on how to use the generated SDKs, read:\n\n- **Web (TypeScript)**: [reference\u002Fsdk_web.md](reference\u002Fsdk_web.md)\n- **Android (Kotlin)**: [reference\u002Fsdk_android.md](reference\u002Fsdk_android.md)\n- **iOS (Swift)**: [reference\u002Fsdk_ios.md](reference\u002Fsdk_ios.md)\n- **Admin (Node.js)**:\n  [reference\u002Fsdk_admin_node.md](reference\u002Fsdk_admin_node.md)\n- **Flutter (Dart)**: [reference\u002Fsdk_flutter.md](reference\u002Fsdk_flutter.md)\n\n______________________________________________________________________\n\n## Feature Capability Map\n\nIf you need to implement a specific feature, consult the mapped reference file:\n\n| Feature                         | Reference File                                               | Key Concepts                                       |\n| :------------------------------ | :----------------------------------------------------------- | :------------------------------------------------- |\n| **Data Modeling**               | [reference\u002Fschema.md](reference\u002Fschema.md)                   | `@table`, `@unique`, `@index`, Relations           |\n| **Vector Search**               | [reference\u002Fsearch.md](reference\u002Fsearch.md)                   | `Vector`, `@col(dataType: \"vector\")`, embeddings   |\n| **Full-Text Search**            | [reference\u002Fsearch.md](reference\u002Fsearch.md)                   | `@searchable`, `movies_search`                     |\n| **Upserting Data**              | [reference\u002Foperations.md](reference\u002Foperations.md)           | `_upsert` mutations                                |\n| **Complex Filters**             | [reference\u002Foperations.md](reference\u002Foperations.md)           | `_or`, `_and`, `_not`, `eq`, `contains`            |\n| **Transactions**                | [reference\u002Foperations.md](reference\u002Foperations.md)           | `@transaction`, `response` binding                 |\n| **Environment Config**          | [reference\u002Fconfig.md](reference\u002Fconfig.md)                   | `dataconnect.yaml`, `connector.yaml`               |\n| **Realtime Subscriptions**      | [reference\u002Frealtime.md](reference\u002Frealtime.md)               | `@refresh`, `subscribe()`, auto-refresh            |\n| **Cloud Functions Integration** | [reference\u002Fcloud_functions.md](reference\u002Fcloud_functions.md) | `onMutationExecuted`, triggering events            |\n| **Data Seeding & Migrations**   | [reference\u002Fdata_seeding.md](reference\u002Fdata_seeding.md)       | `seed_data.gql`, `_insertMany`, Admin SDK bulk     |\n| **Starter Templates**           | [templates.md](templates.md)                                 | CRUD, user-owned resources, many-to-many, SDK init |\n\n______________________________________________________________________\n\n## Deployment & CLI\n\n> **Read [reference\u002Fconfig.md](reference\u002Fconfig.md)** for deep dive on\n> configuration.\n\nFollow these patterns based on your current task:\n\n### How to initialize SQL Connect in a Firebase project\n\n1. Understand the app idea. Ask clarification questions if unclear.\n1. Run `npx -y firebase-tools@latest init dataconnect`.\n1. Validate that the app template and generated SDK are setup.\n\n### How to build apps using SQL Connect locally\n\n1. Start the emulator:\n   `npx -y firebase-tools@latest emulators:start --only dataconnect`.\n1. Write schema and operations.\n1. Seed local test data into `seed_data.gql`. Read\n   [reference\u002Fdata_seeding.md](reference\u002Fdata_seeding.md#local-prototyping-data-seeding).\n1. Run `npx -y firebase-tools@latest dataconnect:compile` or\n   `npx -y firebase-tools@latest dataconnect:sdk:generate` to validate them.\n1. Use the operations in your app and build it.\n\n### How to deploy SQL Connect to Cloud SQL\n\n1. Run `npx -y firebase-tools@latest deploy --only dataconnect`.\n\n## Examples\n\nFor complete, working code examples of schemas and operations, see\n**[examples.md](examples.md)**.\n\nFor ready-to-use starter templates (CRUD, user-owned resources, many-to-many,\nYAML configs, SDK init), see **[templates.md](templates.md)**.\n",{"data":39,"body":40},{"name":4,"description":6},{"type":41,"children":42},"root",[43,52,58,88,95,108,114,119,160,166,192,316,322,334,349,354,418,438,443,723,729,734,747,960,965,998,1003,1077,1081,1087,1092,1510,1513,1519,1535,1540,1546,1572,1578,1640,1646,1660,1666,1680,1693],{"type":44,"tag":45,"props":46,"children":48},"element","h1",{"id":47},"firebase-sql-connect",[49],{"type":50,"value":51},"text","Firebase SQL Connect",{"type":44,"tag":53,"props":54,"children":55},"p",{},[56],{"type":50,"value":57},"Firebase SQL Connect is a relational database service using Cloud SQL for\nPostgreSQL with GraphQL schema, auto-generated queries\u002Fmutations, and type-safe\nSDKs.",{"type":44,"tag":59,"props":60,"children":61},"blockquote",{},[62],{"type":44,"tag":53,"props":63,"children":64},{},[65,71,73,79,81,86],{"type":44,"tag":66,"props":67,"children":68},"span",{},[69],{"type":50,"value":70},"!NOTE",{"type":50,"value":72}," ",{"type":44,"tag":74,"props":75,"children":76},"strong",{},[77],{"type":50,"value":78},"Product Rename",{"type":50,"value":80},": Firebase Data Connect was renamed to ",{"type":44,"tag":74,"props":82,"children":83},{},[84],{"type":50,"value":85},"Firebase\nSQL Connect",{"type":50,"value":87},". All instructions, references, and examples in this skill\nrepository referring to \"Data Connect\" or \"Firebase Data Connect\" apply to\n\"SQL Connect\" and \"Firebase SQL Connect\" as well.",{"type":44,"tag":89,"props":90,"children":92},"h2",{"id":91},"project-structure",[93],{"type":50,"value":94},"Project Structure",{"type":44,"tag":96,"props":97,"children":102},"pre",{"className":98,"code":100,"language":50,"meta":101},[99],"language-text","dataconnect\u002F\n├── dataconnect.yaml      # Service configuration\n├── seed_data.gql         # LOCAL ONLY — prototype\u002Ftest data\n├── schema\u002F\n│   └── schema.gql        # Data model (types with @table)\n└── connector\u002F\n    ├── connector.yaml    # Connector config + SDK generation\n    ├── queries.gql       # Queries\n    └── mutations.gql     # Mutations\n","",[103],{"type":44,"tag":104,"props":105,"children":106},"code",{"__ignoreMap":101},[107],{"type":50,"value":100},{"type":44,"tag":89,"props":109,"children":111},{"id":110},"key-tools-for-validation",[112],{"type":50,"value":113},"Key Tools for Validation",{"type":44,"tag":53,"props":115,"children":116},{},[117],{"type":50,"value":118},"Rely on these two mechanisms to ensure project correctness:",{"type":44,"tag":120,"props":121,"children":122},"ol",{},[123,142],{"type":44,"tag":124,"props":125,"children":126},"li",{},[127,132,134,140],{"type":44,"tag":74,"props":128,"children":129},{},[130],{"type":50,"value":131},"Review GraphQL Schema",{"type":50,"value":133},": Both user-defined and generated extensions (in\n",{"type":44,"tag":104,"props":135,"children":137},{"className":136},[],[138],{"type":50,"value":139},".dataconnect\u002Fschema\u002Fmain\u002F",{"type":50,"value":141},").",{"type":44,"tag":124,"props":143,"children":144},{},[145,150,152,158],{"type":44,"tag":74,"props":146,"children":147},{},[148],{"type":50,"value":149},"Validate Operations",{"type":50,"value":151},": Run\n",{"type":44,"tag":104,"props":153,"children":155},{"className":154},[],[156],{"type":50,"value":157},"npx -y firebase-tools@latest dataconnect:compile",{"type":50,"value":159}," against the schema.",{"type":44,"tag":89,"props":161,"children":163},{"id":162},"operation-strategies-graphql-vs-native-sql",[164],{"type":50,"value":165},"Operation Strategies: GraphQL vs. Native SQL",{"type":44,"tag":53,"props":167,"children":168},{},[169,171,176,178,183,185,190],{"type":50,"value":170},"Always default to ",{"type":44,"tag":74,"props":172,"children":173},{},[174],{"type":50,"value":175},"Native GraphQL",{"type":50,"value":177},". ",{"type":44,"tag":74,"props":179,"children":180},{},[181],{"type":50,"value":182},"Native SQL lacks type safety",{"type":50,"value":184}," and\nbypasses schema-enforced structures. Only use ",{"type":44,"tag":74,"props":186,"children":187},{},[188],{"type":50,"value":189},"Native SQL",{"type":50,"value":191}," when the user\nexplicitly requests it or when the task requires advanced database features.",{"type":44,"tag":193,"props":194,"children":195},"table",{},[196,220],{"type":44,"tag":197,"props":198,"children":199},"thead",{},[200],{"type":44,"tag":201,"props":202,"children":203},"tr",{},[204,210,215],{"type":44,"tag":205,"props":206,"children":207},"th",{},[208],{"type":50,"value":209},"Strategy",{"type":44,"tag":205,"props":211,"children":212},{},[213],{"type":50,"value":214},"When to use",{"type":44,"tag":205,"props":216,"children":217},{},[218],{"type":50,"value":219},"Implementation",{"type":44,"tag":221,"props":222,"children":223},"tbody",{},[224,263],{"type":44,"tag":201,"props":225,"children":226},{},[227,237,242],{"type":44,"tag":228,"props":229,"children":230},"td",{},[231,235],{"type":44,"tag":74,"props":232,"children":233},{},[234],{"type":50,"value":175},{"type":50,"value":236}," (Default)",{"type":44,"tag":228,"props":238,"children":239},{},[240],{"type":50,"value":241},"Almost all use cases. Standard CRUD, basic filtering\u002Fsorting, simple relational joins. Requires full type safety.",{"type":44,"tag":228,"props":243,"children":244},{},[245,247,253,255,261],{"type":50,"value":246},"Auto-generated fields (",{"type":44,"tag":104,"props":248,"children":250},{"className":249},[],[251],{"type":50,"value":252},"movie_insert",{"type":50,"value":254},", ",{"type":44,"tag":104,"props":256,"children":258},{"className":257},[],[259],{"type":50,"value":260},"movies",{"type":50,"value":262},"). Strong typing and schema enforcement.",{"type":44,"tag":201,"props":264,"children":265},{},[266,275,288],{"type":44,"tag":228,"props":267,"children":268},{},[269,273],{"type":44,"tag":74,"props":270,"children":271},{},[272],{"type":50,"value":189},{"type":50,"value":274}," (Advanced)",{"type":44,"tag":228,"props":276,"children":277},{},[278,280,286],{"type":50,"value":279},"PostgreSQL extensions (e.g., PostGIS), window functions (",{"type":44,"tag":104,"props":281,"children":283},{"className":282},[],[284],{"type":50,"value":285},"RANK()",{"type":50,"value":287},"), complex aggregations, or highly tuned sub-queries.",{"type":44,"tag":228,"props":289,"children":290},{},[291,293,299,300,306,308,314],{"type":50,"value":292},"Raw SQL string literals via ",{"type":44,"tag":104,"props":294,"children":296},{"className":295},[],[297],{"type":50,"value":298},"_select",{"type":50,"value":254},{"type":44,"tag":104,"props":301,"children":303},{"className":302},[],[304],{"type":50,"value":305},"_execute",{"type":50,"value":307},", etc. Requires strict positional parameters (",{"type":44,"tag":104,"props":309,"children":311},{"className":310},[],[312],{"type":50,"value":313},"$1",{"type":50,"value":315},"). No type safety.",{"type":44,"tag":89,"props":317,"children":319},{"id":318},"development-workflow",[320],{"type":50,"value":321},"Development Workflow",{"type":44,"tag":53,"props":323,"children":324},{},[325,327,332],{"type":50,"value":326},"Follow this strict workflow to build your application. You ",{"type":44,"tag":74,"props":328,"children":329},{},[330],{"type":50,"value":331},"must",{"type":50,"value":333}," read the\nlinked reference files for each step to understand the syntax and available\nfeatures.",{"type":44,"tag":335,"props":336,"children":338},"h3",{"id":337},"_1-define-data-model-schemaschemagql",[339,341,347],{"type":50,"value":340},"1. Define Data Model (",{"type":44,"tag":104,"props":342,"children":344},{"className":343},[],[345],{"type":50,"value":346},"schema\u002Fschema.gql",{"type":50,"value":348},")",{"type":44,"tag":53,"props":350,"children":351},{},[352],{"type":50,"value":353},"Define your GraphQL types, tables, and relationships (which map to a Postgres\nschema).",{"type":44,"tag":59,"props":355,"children":356},{},[357,373],{"type":44,"tag":53,"props":358,"children":359},{},[360,371],{"type":44,"tag":74,"props":361,"children":362},{},[363,365],{"type":50,"value":364},"Read ",{"type":44,"tag":366,"props":367,"children":369},"a",{"href":368},"reference\u002Fschema.md",[370],{"type":50,"value":368},{"type":50,"value":372}," for:",{"type":44,"tag":374,"props":375,"children":376},"ul",{},[377,400,413],{"type":44,"tag":124,"props":378,"children":379},{},[380,386,387,393,394],{"type":44,"tag":104,"props":381,"children":383},{"className":382},[],[384],{"type":50,"value":385},"@table",{"type":50,"value":254},{"type":44,"tag":104,"props":388,"children":390},{"className":389},[],[391],{"type":50,"value":392},"@col",{"type":50,"value":254},{"type":44,"tag":104,"props":395,"children":397},{"className":396},[],[398],{"type":50,"value":399},"@default",{"type":44,"tag":124,"props":401,"children":402},{},[403,405,411],{"type":50,"value":404},"Relationships (",{"type":44,"tag":104,"props":406,"children":408},{"className":407},[],[409],{"type":50,"value":410},"@ref",{"type":50,"value":412},", one-to-many, many-to-many)",{"type":44,"tag":124,"props":414,"children":415},{},[416],{"type":50,"value":417},"Data types (UUID, Vector, JSON, etc.)",{"type":44,"tag":335,"props":419,"children":421},{"id":420},"_2-define-authorized-operations-connectorqueriesgql-connectormutationsgql",[422,424,430,431,437],{"type":50,"value":423},"2. Define Authorized Operations (",{"type":44,"tag":104,"props":425,"children":427},{"className":426},[],[428],{"type":50,"value":429},"connector\u002Fqueries.gql",{"type":50,"value":254},{"type":44,"tag":104,"props":432,"children":434},{"className":433},[],[435],{"type":50,"value":436},"connector\u002Fmutations.gql",{"type":50,"value":348},{"type":44,"tag":53,"props":439,"children":440},{},[441],{"type":50,"value":442},"Write the queries and mutations your client will use, including authorization\nlogic. SQL Connect is secure by default.",{"type":44,"tag":59,"props":444,"children":445},{},[446,459,579,593,626,640,659,673],{"type":44,"tag":53,"props":447,"children":448},{},[449,458],{"type":44,"tag":74,"props":450,"children":451},{},[452,453],{"type":50,"value":364},{"type":44,"tag":366,"props":454,"children":456},{"href":455},"reference\u002Foperations.md",[457],{"type":50,"value":455},{"type":50,"value":372},{"type":44,"tag":374,"props":460,"children":461},{},[462,503,536,554],{"type":44,"tag":124,"props":463,"children":464},{},[465,470,472,478,480,486,488,494,496,502],{"type":44,"tag":74,"props":466,"children":467},{},[468],{"type":50,"value":469},"Queries",{"type":50,"value":471},": Filtering (",{"type":44,"tag":104,"props":473,"children":475},{"className":474},[],[476],{"type":50,"value":477},"where",{"type":50,"value":479},"), Ordering (",{"type":44,"tag":104,"props":481,"children":483},{"className":482},[],[484],{"type":50,"value":485},"orderBy",{"type":50,"value":487},"), Pagination\n(",{"type":44,"tag":104,"props":489,"children":491},{"className":490},[],[492],{"type":50,"value":493},"limit",{"type":50,"value":495},"\u002F",{"type":44,"tag":104,"props":497,"children":499},{"className":498},[],[500],{"type":50,"value":501},"offset",{"type":50,"value":141},{"type":44,"tag":124,"props":504,"children":505},{},[506,511,513,519,521,527,529,535],{"type":44,"tag":74,"props":507,"children":508},{},[509],{"type":50,"value":510},"Mutations",{"type":50,"value":512},": Create (",{"type":44,"tag":104,"props":514,"children":516},{"className":515},[],[517],{"type":50,"value":518},"_insert",{"type":50,"value":520},"), Update (",{"type":44,"tag":104,"props":522,"children":524},{"className":523},[],[525],{"type":50,"value":526},"_update",{"type":50,"value":528},"), Delete (",{"type":44,"tag":104,"props":530,"children":532},{"className":531},[],[533],{"type":50,"value":534},"_delete",{"type":50,"value":141},{"type":44,"tag":124,"props":537,"children":538},{},[539,544,546,552],{"type":44,"tag":74,"props":540,"children":541},{},[542],{"type":50,"value":543},"Upserts",{"type":50,"value":545},": Use ",{"type":44,"tag":104,"props":547,"children":549},{"className":548},[],[550],{"type":50,"value":551},"_upsert",{"type":50,"value":553}," to \"insert or update\" records (CRITICAL for user\nprofiles).",{"type":44,"tag":124,"props":555,"children":556},{},[557,562,563,569,571,577],{"type":44,"tag":74,"props":558,"children":559},{},[560],{"type":50,"value":561},"Transactions",{"type":50,"value":545},{"type":44,"tag":104,"props":564,"children":566},{"className":565},[],[567],{"type":50,"value":568},"@transaction",{"type":50,"value":570}," for multi-step atomic operations. Use\n",{"type":44,"tag":104,"props":572,"children":574},{"className":573},[],[575],{"type":50,"value":576},"_expr: \"response.\u003CprevStep>\"",{"type":50,"value":578}," to pass data between steps.",{"type":44,"tag":53,"props":580,"children":581},{},[582,591],{"type":44,"tag":74,"props":583,"children":584},{},[585,586],{"type":50,"value":364},{"type":44,"tag":366,"props":587,"children":589},{"href":588},"reference\u002Fsecurity.md",[590],{"type":50,"value":588},{"type":50,"value":592}," for authorization:",{"type":44,"tag":374,"props":594,"children":595},{},[596,607],{"type":44,"tag":124,"props":597,"children":598},{},[599,605],{"type":44,"tag":104,"props":600,"children":602},{"className":601},[],[603],{"type":50,"value":604},"@auth(level: ...)",{"type":50,"value":606}," for PUBLIC, USER, or NO_ACCESS.",{"type":44,"tag":124,"props":608,"children":609},{},[610,616,618,624],{"type":44,"tag":104,"props":611,"children":613},{"className":612},[],[614],{"type":50,"value":615},"@check",{"type":50,"value":617}," and ",{"type":44,"tag":104,"props":619,"children":621},{"className":620},[],[622],{"type":50,"value":623},"@redact",{"type":50,"value":625}," for row-level security and validation.",{"type":44,"tag":53,"props":627,"children":628},{},[629,638],{"type":44,"tag":74,"props":630,"children":631},{},[632,633],{"type":50,"value":364},{"type":44,"tag":366,"props":634,"children":636},{"href":635},"reference\u002Frealtime.md",[637],{"type":50,"value":635},{"type":50,"value":639}," for real-time\nsubscriptions:",{"type":44,"tag":374,"props":641,"children":642},{},[643,654],{"type":44,"tag":124,"props":644,"children":645},{},[646,652],{"type":44,"tag":104,"props":647,"children":649},{"className":648},[],[650],{"type":50,"value":651},"@refresh",{"type":50,"value":653}," directive for time-based polling and event-driven updates.",{"type":44,"tag":124,"props":655,"children":656},{},[657],{"type":50,"value":658},"CEL conditions to scope refresh triggers precisely.",{"type":44,"tag":53,"props":660,"children":661},{},[662,671],{"type":44,"tag":74,"props":663,"children":664},{},[665,666],{"type":50,"value":364},{"type":44,"tag":366,"props":667,"children":669},{"href":668},"reference\u002Fnative_sql.md",[670],{"type":50,"value":668},{"type":50,"value":672}," for Native SQL\noperations:",{"type":44,"tag":374,"props":674,"children":675},{},[676,699,718],{"type":44,"tag":124,"props":677,"children":678},{},[679,681,686,687,693,694],{"type":50,"value":680},"Embedding raw SQL with ",{"type":44,"tag":104,"props":682,"children":684},{"className":683},[],[685],{"type":50,"value":298},{"type":50,"value":254},{"type":44,"tag":104,"props":688,"children":690},{"className":689},[],[691],{"type":50,"value":692},"_selectFirst",{"type":50,"value":254},{"type":44,"tag":104,"props":695,"children":697},{"className":696},[],[698],{"type":50,"value":305},{"type":44,"tag":124,"props":700,"children":701},{},[702,704,709,710,716],{"type":50,"value":703},"Strict rules for positional parameters (",{"type":44,"tag":104,"props":705,"children":707},{"className":706},[],[708],{"type":50,"value":313},{"type":50,"value":254},{"type":44,"tag":104,"props":711,"children":713},{"className":712},[],[714],{"type":50,"value":715},"$2",{"type":50,"value":717},"), quoting, and CTEs",{"type":44,"tag":124,"props":719,"children":720},{},[721],{"type":50,"value":722},"Advanced PostgreSQL features (PostGIS, Window Functions)",{"type":44,"tag":335,"props":724,"children":726},{"id":725},"_3-use-type-safe-sdk-in-your-apps",[727],{"type":50,"value":728},"3. Use type-safe SDK in your apps",{"type":44,"tag":53,"props":730,"children":731},{},[732],{"type":50,"value":733},"Generate type-safe code for your client platform.",{"type":44,"tag":53,"props":735,"children":736},{},[737,739,745],{"type":50,"value":738},"Configure SDK generation in ",{"type":44,"tag":104,"props":740,"children":742},{"className":741},[],[743],{"type":50,"value":744},"connector.yaml",{"type":50,"value":746},":",{"type":44,"tag":96,"props":748,"children":752},{"className":749,"code":750,"language":751,"meta":101,"style":101},"language-yaml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","connectorId: my-connector\ngenerate:\n  javascriptSdk:\n    outputDir: \"..\u002Fweb-app\u002Fsrc\u002Flib\u002Fdataconnect\"\n    package: \"@movie-app\u002Fdataconnect\"\n  kotlinSdk:\n    outputDir: \"..\u002Fandroid-app\u002Fapp\u002Fsrc\u002Fmain\u002Fkotlin\u002Fcom\u002Fexample\u002Fdataconnect\"\n    package: \"com.example.dataconnect\"\n  swiftSdk:\n    outputDir: \"..\u002Fios-app\u002FDataConnect\"\n","yaml",[753],{"type":44,"tag":104,"props":754,"children":755},{"__ignoreMap":101},[756,778,792,805,833,859,872,897,922,935],{"type":44,"tag":66,"props":757,"children":760},{"class":758,"line":759},"line",1,[761,767,772],{"type":44,"tag":66,"props":762,"children":764},{"style":763},"--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178",[765],{"type":50,"value":766},"connectorId",{"type":44,"tag":66,"props":768,"children":770},{"style":769},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[771],{"type":50,"value":746},{"type":44,"tag":66,"props":773,"children":775},{"style":774},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[776],{"type":50,"value":777}," my-connector\n",{"type":44,"tag":66,"props":779,"children":781},{"class":758,"line":780},2,[782,787],{"type":44,"tag":66,"props":783,"children":784},{"style":763},[785],{"type":50,"value":786},"generate",{"type":44,"tag":66,"props":788,"children":789},{"style":769},[790],{"type":50,"value":791},":\n",{"type":44,"tag":66,"props":793,"children":795},{"class":758,"line":794},3,[796,801],{"type":44,"tag":66,"props":797,"children":798},{"style":763},[799],{"type":50,"value":800},"  javascriptSdk",{"type":44,"tag":66,"props":802,"children":803},{"style":769},[804],{"type":50,"value":791},{"type":44,"tag":66,"props":806,"children":808},{"class":758,"line":807},4,[809,814,818,823,828],{"type":44,"tag":66,"props":810,"children":811},{"style":763},[812],{"type":50,"value":813},"    outputDir",{"type":44,"tag":66,"props":815,"children":816},{"style":769},[817],{"type":50,"value":746},{"type":44,"tag":66,"props":819,"children":820},{"style":769},[821],{"type":50,"value":822}," \"",{"type":44,"tag":66,"props":824,"children":825},{"style":774},[826],{"type":50,"value":827},"..\u002Fweb-app\u002Fsrc\u002Flib\u002Fdataconnect",{"type":44,"tag":66,"props":829,"children":830},{"style":769},[831],{"type":50,"value":832},"\"\n",{"type":44,"tag":66,"props":834,"children":836},{"class":758,"line":835},5,[837,842,846,850,855],{"type":44,"tag":66,"props":838,"children":839},{"style":763},[840],{"type":50,"value":841},"    package",{"type":44,"tag":66,"props":843,"children":844},{"style":769},[845],{"type":50,"value":746},{"type":44,"tag":66,"props":847,"children":848},{"style":769},[849],{"type":50,"value":822},{"type":44,"tag":66,"props":851,"children":852},{"style":774},[853],{"type":50,"value":854},"@movie-app\u002Fdataconnect",{"type":44,"tag":66,"props":856,"children":857},{"style":769},[858],{"type":50,"value":832},{"type":44,"tag":66,"props":860,"children":862},{"class":758,"line":861},6,[863,868],{"type":44,"tag":66,"props":864,"children":865},{"style":763},[866],{"type":50,"value":867},"  kotlinSdk",{"type":44,"tag":66,"props":869,"children":870},{"style":769},[871],{"type":50,"value":791},{"type":44,"tag":66,"props":873,"children":875},{"class":758,"line":874},7,[876,880,884,888,893],{"type":44,"tag":66,"props":877,"children":878},{"style":763},[879],{"type":50,"value":813},{"type":44,"tag":66,"props":881,"children":882},{"style":769},[883],{"type":50,"value":746},{"type":44,"tag":66,"props":885,"children":886},{"style":769},[887],{"type":50,"value":822},{"type":44,"tag":66,"props":889,"children":890},{"style":774},[891],{"type":50,"value":892},"..\u002Fandroid-app\u002Fapp\u002Fsrc\u002Fmain\u002Fkotlin\u002Fcom\u002Fexample\u002Fdataconnect",{"type":44,"tag":66,"props":894,"children":895},{"style":769},[896],{"type":50,"value":832},{"type":44,"tag":66,"props":898,"children":900},{"class":758,"line":899},8,[901,905,909,913,918],{"type":44,"tag":66,"props":902,"children":903},{"style":763},[904],{"type":50,"value":841},{"type":44,"tag":66,"props":906,"children":907},{"style":769},[908],{"type":50,"value":746},{"type":44,"tag":66,"props":910,"children":911},{"style":769},[912],{"type":50,"value":822},{"type":44,"tag":66,"props":914,"children":915},{"style":774},[916],{"type":50,"value":917},"com.example.dataconnect",{"type":44,"tag":66,"props":919,"children":920},{"style":769},[921],{"type":50,"value":832},{"type":44,"tag":66,"props":923,"children":925},{"class":758,"line":924},9,[926,931],{"type":44,"tag":66,"props":927,"children":928},{"style":763},[929],{"type":50,"value":930},"  swiftSdk",{"type":44,"tag":66,"props":932,"children":933},{"style":769},[934],{"type":50,"value":791},{"type":44,"tag":66,"props":936,"children":938},{"class":758,"line":937},10,[939,943,947,951,956],{"type":44,"tag":66,"props":940,"children":941},{"style":763},[942],{"type":50,"value":813},{"type":44,"tag":66,"props":944,"children":945},{"style":769},[946],{"type":50,"value":746},{"type":44,"tag":66,"props":948,"children":949},{"style":769},[950],{"type":50,"value":822},{"type":44,"tag":66,"props":952,"children":953},{"style":774},[954],{"type":50,"value":955},"..\u002Fios-app\u002FDataConnect",{"type":44,"tag":66,"props":957,"children":958},{"style":769},[959],{"type":50,"value":832},{"type":44,"tag":53,"props":961,"children":962},{},[963],{"type":50,"value":964},"Generate SDKs:",{"type":44,"tag":96,"props":966,"children":970},{"className":967,"code":968,"language":969,"meta":101,"style":101},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","npx -y firebase-tools@latest dataconnect:sdk:generate\n","bash",[971],{"type":44,"tag":104,"props":972,"children":973},{"__ignoreMap":101},[974],{"type":44,"tag":66,"props":975,"children":976},{"class":758,"line":759},[977,983,988,993],{"type":44,"tag":66,"props":978,"children":980},{"style":979},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[981],{"type":50,"value":982},"npx",{"type":44,"tag":66,"props":984,"children":985},{"style":774},[986],{"type":50,"value":987}," -y",{"type":44,"tag":66,"props":989,"children":990},{"style":774},[991],{"type":50,"value":992}," firebase-tools@latest",{"type":44,"tag":66,"props":994,"children":995},{"style":774},[996],{"type":50,"value":997}," dataconnect:sdk:generate\n",{"type":44,"tag":53,"props":999,"children":1000},{},[1001],{"type":50,"value":1002},"For platform-specific instructions on how to use the generated SDKs, read:",{"type":44,"tag":374,"props":1004,"children":1005},{},[1006,1021,1035,1049,1063],{"type":44,"tag":124,"props":1007,"children":1008},{},[1009,1014,1016],{"type":44,"tag":74,"props":1010,"children":1011},{},[1012],{"type":50,"value":1013},"Web (TypeScript)",{"type":50,"value":1015},": ",{"type":44,"tag":366,"props":1017,"children":1019},{"href":1018},"reference\u002Fsdk_web.md",[1020],{"type":50,"value":1018},{"type":44,"tag":124,"props":1022,"children":1023},{},[1024,1029,1030],{"type":44,"tag":74,"props":1025,"children":1026},{},[1027],{"type":50,"value":1028},"Android (Kotlin)",{"type":50,"value":1015},{"type":44,"tag":366,"props":1031,"children":1033},{"href":1032},"reference\u002Fsdk_android.md",[1034],{"type":50,"value":1032},{"type":44,"tag":124,"props":1036,"children":1037},{},[1038,1043,1044],{"type":44,"tag":74,"props":1039,"children":1040},{},[1041],{"type":50,"value":1042},"iOS (Swift)",{"type":50,"value":1015},{"type":44,"tag":366,"props":1045,"children":1047},{"href":1046},"reference\u002Fsdk_ios.md",[1048],{"type":50,"value":1046},{"type":44,"tag":124,"props":1050,"children":1051},{},[1052,1057,1058],{"type":44,"tag":74,"props":1053,"children":1054},{},[1055],{"type":50,"value":1056},"Admin (Node.js)",{"type":50,"value":791},{"type":44,"tag":366,"props":1059,"children":1061},{"href":1060},"reference\u002Fsdk_admin_node.md",[1062],{"type":50,"value":1060},{"type":44,"tag":124,"props":1064,"children":1065},{},[1066,1071,1072],{"type":44,"tag":74,"props":1067,"children":1068},{},[1069],{"type":50,"value":1070},"Flutter (Dart)",{"type":50,"value":1015},{"type":44,"tag":366,"props":1073,"children":1075},{"href":1074},"reference\u002Fsdk_flutter.md",[1076],{"type":50,"value":1074},{"type":44,"tag":1078,"props":1079,"children":1080},"hr",{},[],{"type":44,"tag":89,"props":1082,"children":1084},{"id":1083},"feature-capability-map",[1085],{"type":50,"value":1086},"Feature Capability Map",{"type":44,"tag":53,"props":1088,"children":1089},{},[1090],{"type":50,"value":1091},"If you need to implement a specific feature, consult the mapped reference file:",{"type":44,"tag":193,"props":1093,"children":1094},{},[1095,1117],{"type":44,"tag":197,"props":1096,"children":1097},{},[1098],{"type":44,"tag":201,"props":1099,"children":1100},{},[1101,1107,1112],{"type":44,"tag":205,"props":1102,"children":1104},{"align":1103},"left",[1105],{"type":50,"value":1106},"Feature",{"type":44,"tag":205,"props":1108,"children":1109},{"align":1103},[1110],{"type":50,"value":1111},"Reference File",{"type":44,"tag":205,"props":1113,"children":1114},{"align":1103},[1115],{"type":50,"value":1116},"Key Concepts",{"type":44,"tag":221,"props":1118,"children":1119},{},[1120,1162,1199,1233,1261,1316,1350,1384,1419,1449,1486],{"type":44,"tag":201,"props":1121,"children":1122},{},[1123,1131,1138],{"type":44,"tag":228,"props":1124,"children":1125},{"align":1103},[1126],{"type":44,"tag":74,"props":1127,"children":1128},{},[1129],{"type":50,"value":1130},"Data Modeling",{"type":44,"tag":228,"props":1132,"children":1133},{"align":1103},[1134],{"type":44,"tag":366,"props":1135,"children":1136},{"href":368},[1137],{"type":50,"value":368},{"type":44,"tag":228,"props":1139,"children":1140},{"align":1103},[1141,1146,1147,1153,1154,1160],{"type":44,"tag":104,"props":1142,"children":1144},{"className":1143},[],[1145],{"type":50,"value":385},{"type":50,"value":254},{"type":44,"tag":104,"props":1148,"children":1150},{"className":1149},[],[1151],{"type":50,"value":1152},"@unique",{"type":50,"value":254},{"type":44,"tag":104,"props":1155,"children":1157},{"className":1156},[],[1158],{"type":50,"value":1159},"@index",{"type":50,"value":1161},", Relations",{"type":44,"tag":201,"props":1163,"children":1164},{},[1165,1173,1181],{"type":44,"tag":228,"props":1166,"children":1167},{"align":1103},[1168],{"type":44,"tag":74,"props":1169,"children":1170},{},[1171],{"type":50,"value":1172},"Vector Search",{"type":44,"tag":228,"props":1174,"children":1175},{"align":1103},[1176],{"type":44,"tag":366,"props":1177,"children":1179},{"href":1178},"reference\u002Fsearch.md",[1180],{"type":50,"value":1178},{"type":44,"tag":228,"props":1182,"children":1183},{"align":1103},[1184,1190,1191,1197],{"type":44,"tag":104,"props":1185,"children":1187},{"className":1186},[],[1188],{"type":50,"value":1189},"Vector",{"type":50,"value":254},{"type":44,"tag":104,"props":1192,"children":1194},{"className":1193},[],[1195],{"type":50,"value":1196},"@col(dataType: \"vector\")",{"type":50,"value":1198},", embeddings",{"type":44,"tag":201,"props":1200,"children":1201},{},[1202,1210,1217],{"type":44,"tag":228,"props":1203,"children":1204},{"align":1103},[1205],{"type":44,"tag":74,"props":1206,"children":1207},{},[1208],{"type":50,"value":1209},"Full-Text Search",{"type":44,"tag":228,"props":1211,"children":1212},{"align":1103},[1213],{"type":44,"tag":366,"props":1214,"children":1215},{"href":1178},[1216],{"type":50,"value":1178},{"type":44,"tag":228,"props":1218,"children":1219},{"align":1103},[1220,1226,1227],{"type":44,"tag":104,"props":1221,"children":1223},{"className":1222},[],[1224],{"type":50,"value":1225},"@searchable",{"type":50,"value":254},{"type":44,"tag":104,"props":1228,"children":1230},{"className":1229},[],[1231],{"type":50,"value":1232},"movies_search",{"type":44,"tag":201,"props":1234,"children":1235},{},[1236,1244,1251],{"type":44,"tag":228,"props":1237,"children":1238},{"align":1103},[1239],{"type":44,"tag":74,"props":1240,"children":1241},{},[1242],{"type":50,"value":1243},"Upserting Data",{"type":44,"tag":228,"props":1245,"children":1246},{"align":1103},[1247],{"type":44,"tag":366,"props":1248,"children":1249},{"href":455},[1250],{"type":50,"value":455},{"type":44,"tag":228,"props":1252,"children":1253},{"align":1103},[1254,1259],{"type":44,"tag":104,"props":1255,"children":1257},{"className":1256},[],[1258],{"type":50,"value":551},{"type":50,"value":1260}," mutations",{"type":44,"tag":201,"props":1262,"children":1263},{},[1264,1272,1279],{"type":44,"tag":228,"props":1265,"children":1266},{"align":1103},[1267],{"type":44,"tag":74,"props":1268,"children":1269},{},[1270],{"type":50,"value":1271},"Complex Filters",{"type":44,"tag":228,"props":1273,"children":1274},{"align":1103},[1275],{"type":44,"tag":366,"props":1276,"children":1277},{"href":455},[1278],{"type":50,"value":455},{"type":44,"tag":228,"props":1280,"children":1281},{"align":1103},[1282,1288,1289,1295,1296,1302,1303,1309,1310],{"type":44,"tag":104,"props":1283,"children":1285},{"className":1284},[],[1286],{"type":50,"value":1287},"_or",{"type":50,"value":254},{"type":44,"tag":104,"props":1290,"children":1292},{"className":1291},[],[1293],{"type":50,"value":1294},"_and",{"type":50,"value":254},{"type":44,"tag":104,"props":1297,"children":1299},{"className":1298},[],[1300],{"type":50,"value":1301},"_not",{"type":50,"value":254},{"type":44,"tag":104,"props":1304,"children":1306},{"className":1305},[],[1307],{"type":50,"value":1308},"eq",{"type":50,"value":254},{"type":44,"tag":104,"props":1311,"children":1313},{"className":1312},[],[1314],{"type":50,"value":1315},"contains",{"type":44,"tag":201,"props":1317,"children":1318},{},[1319,1326,1333],{"type":44,"tag":228,"props":1320,"children":1321},{"align":1103},[1322],{"type":44,"tag":74,"props":1323,"children":1324},{},[1325],{"type":50,"value":561},{"type":44,"tag":228,"props":1327,"children":1328},{"align":1103},[1329],{"type":44,"tag":366,"props":1330,"children":1331},{"href":455},[1332],{"type":50,"value":455},{"type":44,"tag":228,"props":1334,"children":1335},{"align":1103},[1336,1341,1342,1348],{"type":44,"tag":104,"props":1337,"children":1339},{"className":1338},[],[1340],{"type":50,"value":568},{"type":50,"value":254},{"type":44,"tag":104,"props":1343,"children":1345},{"className":1344},[],[1346],{"type":50,"value":1347},"response",{"type":50,"value":1349}," binding",{"type":44,"tag":201,"props":1351,"children":1352},{},[1353,1361,1369],{"type":44,"tag":228,"props":1354,"children":1355},{"align":1103},[1356],{"type":44,"tag":74,"props":1357,"children":1358},{},[1359],{"type":50,"value":1360},"Environment Config",{"type":44,"tag":228,"props":1362,"children":1363},{"align":1103},[1364],{"type":44,"tag":366,"props":1365,"children":1367},{"href":1366},"reference\u002Fconfig.md",[1368],{"type":50,"value":1366},{"type":44,"tag":228,"props":1370,"children":1371},{"align":1103},[1372,1378,1379],{"type":44,"tag":104,"props":1373,"children":1375},{"className":1374},[],[1376],{"type":50,"value":1377},"dataconnect.yaml",{"type":50,"value":254},{"type":44,"tag":104,"props":1380,"children":1382},{"className":1381},[],[1383],{"type":50,"value":744},{"type":44,"tag":201,"props":1385,"children":1386},{},[1387,1395,1402],{"type":44,"tag":228,"props":1388,"children":1389},{"align":1103},[1390],{"type":44,"tag":74,"props":1391,"children":1392},{},[1393],{"type":50,"value":1394},"Realtime Subscriptions",{"type":44,"tag":228,"props":1396,"children":1397},{"align":1103},[1398],{"type":44,"tag":366,"props":1399,"children":1400},{"href":635},[1401],{"type":50,"value":635},{"type":44,"tag":228,"props":1403,"children":1404},{"align":1103},[1405,1410,1411,1417],{"type":44,"tag":104,"props":1406,"children":1408},{"className":1407},[],[1409],{"type":50,"value":651},{"type":50,"value":254},{"type":44,"tag":104,"props":1412,"children":1414},{"className":1413},[],[1415],{"type":50,"value":1416},"subscribe()",{"type":50,"value":1418},", auto-refresh",{"type":44,"tag":201,"props":1420,"children":1421},{},[1422,1430,1438],{"type":44,"tag":228,"props":1423,"children":1424},{"align":1103},[1425],{"type":44,"tag":74,"props":1426,"children":1427},{},[1428],{"type":50,"value":1429},"Cloud Functions Integration",{"type":44,"tag":228,"props":1431,"children":1432},{"align":1103},[1433],{"type":44,"tag":366,"props":1434,"children":1436},{"href":1435},"reference\u002Fcloud_functions.md",[1437],{"type":50,"value":1435},{"type":44,"tag":228,"props":1439,"children":1440},{"align":1103},[1441,1447],{"type":44,"tag":104,"props":1442,"children":1444},{"className":1443},[],[1445],{"type":50,"value":1446},"onMutationExecuted",{"type":50,"value":1448},", triggering events",{"type":44,"tag":201,"props":1450,"children":1451},{},[1452,1460,1468],{"type":44,"tag":228,"props":1453,"children":1454},{"align":1103},[1455],{"type":44,"tag":74,"props":1456,"children":1457},{},[1458],{"type":50,"value":1459},"Data Seeding & Migrations",{"type":44,"tag":228,"props":1461,"children":1462},{"align":1103},[1463],{"type":44,"tag":366,"props":1464,"children":1466},{"href":1465},"reference\u002Fdata_seeding.md",[1467],{"type":50,"value":1465},{"type":44,"tag":228,"props":1469,"children":1470},{"align":1103},[1471,1477,1478,1484],{"type":44,"tag":104,"props":1472,"children":1474},{"className":1473},[],[1475],{"type":50,"value":1476},"seed_data.gql",{"type":50,"value":254},{"type":44,"tag":104,"props":1479,"children":1481},{"className":1480},[],[1482],{"type":50,"value":1483},"_insertMany",{"type":50,"value":1485},", Admin SDK bulk",{"type":44,"tag":201,"props":1487,"children":1488},{},[1489,1497,1505],{"type":44,"tag":228,"props":1490,"children":1491},{"align":1103},[1492],{"type":44,"tag":74,"props":1493,"children":1494},{},[1495],{"type":50,"value":1496},"Starter Templates",{"type":44,"tag":228,"props":1498,"children":1499},{"align":1103},[1500],{"type":44,"tag":366,"props":1501,"children":1503},{"href":1502},"templates.md",[1504],{"type":50,"value":1502},{"type":44,"tag":228,"props":1506,"children":1507},{"align":1103},[1508],{"type":50,"value":1509},"CRUD, user-owned resources, many-to-many, SDK init",{"type":44,"tag":1078,"props":1511,"children":1512},{},[],{"type":44,"tag":89,"props":1514,"children":1516},{"id":1515},"deployment-cli",[1517],{"type":50,"value":1518},"Deployment & CLI",{"type":44,"tag":59,"props":1520,"children":1521},{},[1522],{"type":44,"tag":53,"props":1523,"children":1524},{},[1525,1533],{"type":44,"tag":74,"props":1526,"children":1527},{},[1528,1529],{"type":50,"value":364},{"type":44,"tag":366,"props":1530,"children":1531},{"href":1366},[1532],{"type":50,"value":1366},{"type":50,"value":1534}," for deep dive on\nconfiguration.",{"type":44,"tag":53,"props":1536,"children":1537},{},[1538],{"type":50,"value":1539},"Follow these patterns based on your current task:",{"type":44,"tag":335,"props":1541,"children":1543},{"id":1542},"how-to-initialize-sql-connect-in-a-firebase-project",[1544],{"type":50,"value":1545},"How to initialize SQL Connect in a Firebase project",{"type":44,"tag":120,"props":1547,"children":1548},{},[1549,1554,1567],{"type":44,"tag":124,"props":1550,"children":1551},{},[1552],{"type":50,"value":1553},"Understand the app idea. Ask clarification questions if unclear.",{"type":44,"tag":124,"props":1555,"children":1556},{},[1557,1559,1565],{"type":50,"value":1558},"Run ",{"type":44,"tag":104,"props":1560,"children":1562},{"className":1561},[],[1563],{"type":50,"value":1564},"npx -y firebase-tools@latest init dataconnect",{"type":50,"value":1566},".",{"type":44,"tag":124,"props":1568,"children":1569},{},[1570],{"type":50,"value":1571},"Validate that the app template and generated SDK are setup.",{"type":44,"tag":335,"props":1573,"children":1575},{"id":1574},"how-to-build-apps-using-sql-connect-locally",[1576],{"type":50,"value":1577},"How to build apps using SQL Connect locally",{"type":44,"tag":120,"props":1579,"children":1580},{},[1581,1593,1598,1616,1635],{"type":44,"tag":124,"props":1582,"children":1583},{},[1584,1586,1592],{"type":50,"value":1585},"Start the emulator:\n",{"type":44,"tag":104,"props":1587,"children":1589},{"className":1588},[],[1590],{"type":50,"value":1591},"npx -y firebase-tools@latest emulators:start --only dataconnect",{"type":50,"value":1566},{"type":44,"tag":124,"props":1594,"children":1595},{},[1596],{"type":50,"value":1597},"Write schema and operations.",{"type":44,"tag":124,"props":1599,"children":1600},{},[1601,1603,1608,1610,1615],{"type":50,"value":1602},"Seed local test data into ",{"type":44,"tag":104,"props":1604,"children":1606},{"className":1605},[],[1607],{"type":50,"value":1476},{"type":50,"value":1609},". Read\n",{"type":44,"tag":366,"props":1611,"children":1613},{"href":1612},"reference\u002Fdata_seeding.md#local-prototyping-data-seeding",[1614],{"type":50,"value":1465},{"type":50,"value":1566},{"type":44,"tag":124,"props":1617,"children":1618},{},[1619,1620,1625,1627,1633],{"type":50,"value":1558},{"type":44,"tag":104,"props":1621,"children":1623},{"className":1622},[],[1624],{"type":50,"value":157},{"type":50,"value":1626}," or\n",{"type":44,"tag":104,"props":1628,"children":1630},{"className":1629},[],[1631],{"type":50,"value":1632},"npx -y firebase-tools@latest dataconnect:sdk:generate",{"type":50,"value":1634}," to validate them.",{"type":44,"tag":124,"props":1636,"children":1637},{},[1638],{"type":50,"value":1639},"Use the operations in your app and build it.",{"type":44,"tag":335,"props":1641,"children":1643},{"id":1642},"how-to-deploy-sql-connect-to-cloud-sql",[1644],{"type":50,"value":1645},"How to deploy SQL Connect to Cloud SQL",{"type":44,"tag":120,"props":1647,"children":1648},{},[1649],{"type":44,"tag":124,"props":1650,"children":1651},{},[1652,1653,1659],{"type":50,"value":1558},{"type":44,"tag":104,"props":1654,"children":1656},{"className":1655},[],[1657],{"type":50,"value":1658},"npx -y firebase-tools@latest deploy --only dataconnect",{"type":50,"value":1566},{"type":44,"tag":89,"props":1661,"children":1663},{"id":1662},"examples",[1664],{"type":50,"value":1665},"Examples",{"type":44,"tag":53,"props":1667,"children":1668},{},[1669,1671,1679],{"type":50,"value":1670},"For complete, working code examples of schemas and operations, see\n",{"type":44,"tag":74,"props":1672,"children":1673},{},[1674],{"type":44,"tag":366,"props":1675,"children":1677},{"href":1676},"examples.md",[1678],{"type":50,"value":1676},{"type":50,"value":1566},{"type":44,"tag":53,"props":1681,"children":1682},{},[1683,1685,1692],{"type":50,"value":1684},"For ready-to-use starter templates (CRUD, user-owned resources, many-to-many,\nYAML configs, SDK init), see ",{"type":44,"tag":74,"props":1686,"children":1687},{},[1688],{"type":44,"tag":366,"props":1689,"children":1690},{"href":1502},[1691],{"type":50,"value":1502},{"type":50,"value":1566},{"type":44,"tag":1694,"props":1695,"children":1696},"style",{},[1697],{"type":50,"value":1698},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":1700,"total":1884},[1701,1717,1732,1752,1767,1781,1801,1809,1822,1835,1853,1869],{"slug":1702,"name":1702,"fn":1703,"description":1704,"org":1705,"tags":1706,"stars":27,"repoUrl":28,"updatedAt":1716},"extension-to-functions-codebase","convert Firebase Extensions to Cloud Functions","Skill for converting an installed Firebase Extension (or extension source) to a standalone Cloud Functions for Firebase codebase or publishable npm package, including upgrading triggers from V1 to V2 and configuring lifecycle hooks and declarative security",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1707,1710,1711,1714],{"name":1708,"slug":1709,"type":15},"Cloud Functions","cloud-functions",{"name":26,"slug":8,"type":15},{"name":1712,"slug":1713,"type":15},"Migration","migration",{"name":1715,"slug":1715,"type":15},"npm","2026-07-31T06:23:32.436718",{"slug":1718,"name":1718,"fn":1719,"description":1720,"org":1721,"tags":1722,"stars":27,"repoUrl":28,"updatedAt":1731},"firebase-ai-logic-basics","integrate Firebase AI Logic","Official skill for integrating Firebase AI Logic (Gemini API) into web applications. Covers setup, multimodal inference, structured output, and security.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1723,1724,1725,1728],{"name":13,"slug":14,"type":15},{"name":26,"slug":8,"type":15},{"name":1726,"slug":1727,"type":15},"Gemini","gemini",{"name":1729,"slug":1730,"type":15},"LLM","llm","2026-07-31T05:53:23.557174",{"slug":1733,"name":1733,"fn":1734,"description":1735,"org":1736,"tags":1737,"stars":27,"repoUrl":28,"updatedAt":1751},"firebase-app-hosting-basics","deploy web apps with Firebase App Hosting","Deploys and manages full-stack web applications (Next.js, Angular) with Server-Side Rendering (SSR) using Firebase App Hosting. Use when deploying Next.js\u002FAngular apps, configuring apphosting.yaml or firebase.json apphosting blocks, managing secrets, setting up GitHub CI\u002FCD, or configuring Blaze billing requirements. Don't use for classic static web hosting, Auth, Firestore, Crashlytics, or Xcode.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1738,1741,1744,1745,1748],{"name":1739,"slug":1740,"type":15},"Angular","angular",{"name":1742,"slug":1743,"type":15},"Deployment","deployment",{"name":26,"slug":8,"type":15},{"name":1746,"slug":1747,"type":15},"Frontend","frontend",{"name":1749,"slug":1750,"type":15},"Next.js","next-js","2026-07-31T05:53:19.57287",{"slug":1753,"name":1753,"fn":1754,"description":1755,"org":1756,"tags":1757,"stars":27,"repoUrl":28,"updatedAt":1766},"firebase-auth-basics","set up Firebase Authentication","Guide for setting up and using Firebase Authentication. Use this skill when the user's app requires user sign-in, user management, or secure data access using auth rules.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1758,1761,1762,1763],{"name":1759,"slug":1760,"type":15},"Auth","auth",{"name":13,"slug":14,"type":15},{"name":26,"slug":8,"type":15},{"name":1764,"slug":1765,"type":15},"Security","security","2026-07-31T05:53:20.79137",{"slug":1768,"name":1768,"fn":1769,"description":1770,"org":1771,"tags":1772,"stars":27,"repoUrl":28,"updatedAt":1780},"firebase-basics","build applications with Firebase","Provides foundational Firebase CLI setup, CLI installation, version checks (`firebase-tools@latest --version`), CLI login (including --no-localhost), project creation, project selection (`firebase use`), and app config file downloads (`google-services.json`, `GoogleService-Info.plist`). Use ONLY for CLI login, project creation\u002Fswitching, or downloading app config files. Don't use for Firebase Hosting deploy, Firestore, Auth, App Hosting, Data Connect, Crashlytics, or Remote Config.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1773,1776,1777,1778,1779],{"name":1774,"slug":1775,"type":15},"Authentication","authentication",{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"name":1742,"slug":1743,"type":15},{"name":26,"slug":8,"type":15},"2026-07-31T05:53:21.570684",{"slug":1782,"name":1782,"fn":1783,"description":1784,"org":1785,"tags":1786,"stars":27,"repoUrl":28,"updatedAt":1800},"firebase-crashlytics","set up and manage Firebase Crashlytics","Comprehensive guide for Firebase Crashlytics, including provisioning and SDK usage. Use this skill when the user needs help setting up Crashlytics, adding crash reporting, or using the Crashlytics SDK in their application.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1787,1790,1791,1794,1797],{"name":1788,"slug":1789,"type":15},"Android","android",{"name":26,"slug":8,"type":15},{"name":1792,"slug":1793,"type":15},"iOS","ios",{"name":1795,"slug":1796,"type":15},"Mobile","mobile",{"name":1798,"slug":1799,"type":15},"Observability","observability","2026-05-01T05:54:14.072678",{"slug":4,"name":4,"fn":5,"description":6,"org":1802,"tags":1803,"stars":27,"repoUrl":28,"updatedAt":29},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1804,1805,1806,1807,1808],{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"name":26,"slug":8,"type":15},{"name":17,"slug":18,"type":15},{"name":23,"slug":24,"type":15},{"slug":1810,"name":1810,"fn":1811,"description":1812,"org":1813,"tags":1814,"stars":27,"repoUrl":28,"updatedAt":1821},"firebase-firestore","manage and query Cloud Firestore databases","Sets up, manages, queries, and configures Cloud Firestore databases (Standard\u002FEnterprise edition), including data modeling, security rules, indexes, and SDK integrations (Web, Python, iOS, Android, Flutter). Use when creating\u002Flisting Firestore databases, defining data models\u002Findexes, writing SDK queries, or integrating Firestore SDKs. Don't use for Firebase Hosting, Data Connect, Auth, Storage\u002FGCS, Crashlytics, Functions, or BigQuery.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1815,1816,1817,1818],{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"name":26,"slug":8,"type":15},{"name":1819,"slug":1820,"type":15},"NoSQL","nosql","2026-07-31T05:53:17.562137",{"slug":1823,"name":1823,"fn":1824,"description":1825,"org":1826,"tags":1827,"stars":27,"repoUrl":28,"updatedAt":1834},"firebase-hosting-basics","deploy static apps with Firebase Hosting","Deploys and configures classic Firebase Hosting for static websites, single-page apps (SPAs), and microservices. Use when deploying static sites\u002FSPAs, setting up custom domains, configuring firebase.json hosting settings (redirects, rewrites, headers, multi-site), or managing preview channels. Don't use for Firebase App Hosting (Next.js\u002FSSR), Auth, Firestore queries\u002Frules, Data Connect, or Crashlytics.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1828,1829,1830,1831],{"name":1742,"slug":1743,"type":15},{"name":26,"slug":8,"type":15},{"name":1746,"slug":1747,"type":15},{"name":1832,"slug":1833,"type":15},"Web Development","web-development","2026-07-31T05:53:22.565034",{"slug":1836,"name":1836,"fn":1837,"description":1838,"org":1839,"tags":1840,"stars":27,"repoUrl":28,"updatedAt":1852},"firebase-remote-config-basics","manage Firebase Remote Config and feature flags","Manages Firebase Remote Config templates, feature flags, loading strategies, and SDKs (Android, iOS). Use when downloading\u002Fdeploying remoteconfig JSON templates, managing version history\u002Ffeature flags, setting in-app defaults, fetchAndActivate(), real-time listeners, or SDK setup. Don't use for Firebase Hosting, Auth, Firestore, Data Connect, Crashlytics, or App Hosting.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1841,1844,1847,1848,1849],{"name":1842,"slug":1843,"type":15},"Configuration","configuration",{"name":1845,"slug":1846,"type":15},"Feature Flags","feature-flags",{"name":26,"slug":8,"type":15},{"name":1795,"slug":1796,"type":15},{"name":1850,"slug":1851,"type":15},"SDK","sdk","2026-07-31T05:53:18.552749",{"slug":1854,"name":1854,"fn":1855,"description":1856,"org":1857,"tags":1858,"stars":27,"repoUrl":28,"updatedAt":1868},"firebase-security-rules-auditor","audit Firestore security rules","Audits Firebase (Firestore, Cloud Storage) security rules for vulnerabilities, privilege escalation, role bypasses, create vs update inconsistencies, resource exhaustion, type safety, size limits, and hasOnly ownership checks. Use when auditing\u002Freviewing rules, running red-team rule assessments, or scoring against auditor checklists. Don't use for Firebase CLI (login, deploy), Auth, Crashlytics, Remote Config, or database queries.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1859,1862,1865,1866,1867],{"name":1860,"slug":1861,"type":15},"Audit","audit",{"name":1863,"slug":1864,"type":15},"Compliance","compliance",{"name":20,"slug":21,"type":15},{"name":26,"slug":8,"type":15},{"name":1764,"slug":1765,"type":15},"2026-07-31T05:53:16.588011",{"slug":1870,"name":1870,"fn":1871,"description":1872,"org":1873,"tags":1874,"stars":27,"repoUrl":28,"updatedAt":1883},"xcode-project-setup","manage Xcode project dependencies and packages","Safely modifies Xcode projects (.pbxproj) to add Swift Packages and link files. Use this skill whenever an iOS project needs dependencies installed (e.g. Firebase, Alamofire).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1875,1876,1877,1880],{"name":1792,"slug":1793,"type":15},{"name":1795,"slug":1796,"type":15},{"name":1878,"slug":1879,"type":15},"Swift","swift",{"name":1881,"slug":1882,"type":15},"Xcode","xcode","2026-05-01T05:54:12.834251",12,{"items":1886,"total":1884},[1887,1894,1901,1909,1916,1924,1932],{"slug":1702,"name":1702,"fn":1703,"description":1704,"org":1888,"tags":1889,"stars":27,"repoUrl":28,"updatedAt":1716},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1890,1891,1892,1893],{"name":1708,"slug":1709,"type":15},{"name":26,"slug":8,"type":15},{"name":1712,"slug":1713,"type":15},{"name":1715,"slug":1715,"type":15},{"slug":1718,"name":1718,"fn":1719,"description":1720,"org":1895,"tags":1896,"stars":27,"repoUrl":28,"updatedAt":1731},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1897,1898,1899,1900],{"name":13,"slug":14,"type":15},{"name":26,"slug":8,"type":15},{"name":1726,"slug":1727,"type":15},{"name":1729,"slug":1730,"type":15},{"slug":1733,"name":1733,"fn":1734,"description":1735,"org":1902,"tags":1903,"stars":27,"repoUrl":28,"updatedAt":1751},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1904,1905,1906,1907,1908],{"name":1739,"slug":1740,"type":15},{"name":1742,"slug":1743,"type":15},{"name":26,"slug":8,"type":15},{"name":1746,"slug":1747,"type":15},{"name":1749,"slug":1750,"type":15},{"slug":1753,"name":1753,"fn":1754,"description":1755,"org":1910,"tags":1911,"stars":27,"repoUrl":28,"updatedAt":1766},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1912,1913,1914,1915],{"name":1759,"slug":1760,"type":15},{"name":13,"slug":14,"type":15},{"name":26,"slug":8,"type":15},{"name":1764,"slug":1765,"type":15},{"slug":1768,"name":1768,"fn":1769,"description":1770,"org":1917,"tags":1918,"stars":27,"repoUrl":28,"updatedAt":1780},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1919,1920,1921,1922,1923],{"name":1774,"slug":1775,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"name":1742,"slug":1743,"type":15},{"name":26,"slug":8,"type":15},{"slug":1782,"name":1782,"fn":1783,"description":1784,"org":1925,"tags":1926,"stars":27,"repoUrl":28,"updatedAt":1800},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1927,1928,1929,1930,1931],{"name":1788,"slug":1789,"type":15},{"name":26,"slug":8,"type":15},{"name":1792,"slug":1793,"type":15},{"name":1795,"slug":1796,"type":15},{"name":1798,"slug":1799,"type":15},{"slug":4,"name":4,"fn":5,"description":6,"org":1933,"tags":1934,"stars":27,"repoUrl":28,"updatedAt":29},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1935,1936,1937,1938,1939],{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"name":26,"slug":8,"type":15},{"name":17,"slug":18,"type":15},{"name":23,"slug":24,"type":15}]