This is a sample app for the preview version of Firebase DataConnect. This service is currently in Private Preview at no cost for a limited time. Sign up for the program at Firebase Data Connect. This quickstart will not work if you don't have access to the preview.

Follow these steps to get up and running with Firebase DataConnect. For more detailed instructions, check out the official documentation.

1. Open Firebase Data Connect in your Firebase Console project and select Get Started.
2. Create a new Data Connect service and a Cloud SQL instance. Ensure the Blaze plan is active. Find pricing details at Firebase Pricing.
3. Choose your server region. If you plan to use vector search, select us-central1.
4. Wait for the Cloud SQL instance to be provisioned. Once it's ready, you can manage it in the Cloud Console.

Ensure the Firebase CLI is installed and up to date:

npm install -g firebase-tools

This repository contains the quickstart to help you explore the functionalities of DataConnect.

1. Clone this repository to your local machine.

2. Navigate to the dataconnect folder and initialize your Firebase project:

   cd ./dataconnect

   (Optional): If you plan to use other Firebase features, run firebase init instead, and select both DataConnect options as well as any additional feature you want to use.

1. Install VS Code.
2. Download and install the Firebase DataConnect extension.
3. Open this quickstart in VS Code and log in to your Firebase account using the Firebase extension.
4. In the Firebase DataConnect VSCode extension, click Start Emulators and confirm that the emulators are running in the terminal.

1. In VS Code, open dataconnect/movie_insert.gql. Ensure the emulators in the Firebase DataConnect extension are running.
2. You should see a Run (local) button at the top of the file. Click this to insert mock movie data into your database.
3. Check the DataConnect Execution terminal to confirm that the data was added successfully.

1. Navigate to the app folder and install dependencies:

   cd ./app
   npm install

2. Start the app:

   npm run dev

1. Create a Web App in the Firebase Console and take note of your App ID.

2. In the Firebase Console, click on Add App. You can ignore the SDK setup for now, but note the generated firebaseConfig object.

3. Replace the firebaseConfig in app/src/lib/firebase.tsx:

   const firebaseConfig = {
     apiKey: "API_KEY",
     authDomain: "PROJECT_ID.firebaseapp.com",
     projectId: "PROJECT_ID",
     storageBucket: "PROJECT_ID.appspot.com",
     messagingSenderId: "SENDER_ID",
     appId: "APP_ID"
   };

4. Build the web app for hosting deployment:

   cd ./app
   npm run build

5. Set up Firebase Authentication with Google Sign-In. Optionally, allow domains for Firebase Auth in your project console (e.g., http://127.0.0.1).

6. Allow domains for Firebase Auth in your project console (e.g., http://127.0.0.1).

7. In dataconnect/dataconnect.yaml, ensure that your instanceId, database, and serviceId match your project configuration:

   specVersion: "v1alpha"
   serviceId: "your-service-id"
   location: "us-central1"
   schema:
     source: "./schema"
     datasource:
       postgresql:
         database: "your-database-id"
         cloudSql:
           instanceId: "your-instance-id"
   connectorDirs: ["./movie-connector"]

8. Deploy your project:

   npm install -g firebase-tools
   firebase login --reauth
   firebase use --add
   firebase deploy --only dataconnect,hosting

9. To compare schema changes, run:

   firebase dataconnect:sql:diff

10. If the changes are acceptable, apply them with:

    firebase dataconnect:sql:migrate

© Google, 2024. Licensed under an Apache-2 license.