Deploying

Backend deployment

Set up a Firebase project with a Firestore database and "Sign in with Google" authentication.

Add your Firebase project ID to the .firebaserc file.

Then, using the Firebase CLI, run:

firebase login  # If not already logged in
firebase deploy

or use one of the following commands to only deploy part(s) of the backend:

firebase deploy --only functions
firebase deploy --only firestore
firebase deploy --only firestore:indexes
firebase deploy --only firestore:rules

See Firebase documentation for additional information.

Allowlist setup

After initializing your Firebase's Firestore, create an allowlist collection at the top level. For each user allowed researcher access (e.g., can create and manage experiments) to your deployment, create a document under allowlist with their email address as the document ID.

Frontend deployment

If you haven't already, follow Firebase instructions to register your web app (under Project settings in the Firebase console). This will generate a custom Firebase config (including apiKey, authDomain, projectId, etc. fields). Copy/paste this config into frontend/firebase_config.ts (which should be forked from frontend/firebase_config.example.ts).

If you'd like to include Google Analytics, replace the placeholder analytics ID in index.html (fork from index.example.html and see TODOs) with your Google Analytics ID.

Tip: To locally run the frontend with the deployed Firebase backend, navigate to the frontend directory and run npm run start:prod.

Finally, to build the frontend in the frontend/dist directory:

npm run build:prod

Then, deploy your build wherever you're hosting the platform (e.g., App Engine)!