Full Stack Development

Local Development

We use Docker and Docker Compose V2 to run the app locally using containers. To build and run the full app with a snapshot of the dev database:

yarn compose up --build

• Firebase emulators run functions code and a local Firestore instance, seeded with a snapshot of the development environment
• A Typesense container runs local search
• A Next.js container builds and serves the frontend with hot-reload
• A Typescript container watches the functions directory and rebuilds on save

CLI Tools

• yarn typesense-admin -e local console starts a node console with a client global for the local environment.
• yarn firebase-admin -e local console starts a node console with firebase, db, auth, admin, and api (MA Legislature API) globals for the local environment.