Install dependencies

From the root of your project, run:

pnpm install

This installs dependencies for all packages in the monorepo.

Environment variables

Your generated project includes a packages/backend/.env file pre-filled with the values you configured in the modeling tool. It should work out of the box for local development.

Still, it's worth reviewing it before running the project — in particular:

  • DATABASE_NAME — make sure it matches the PostgreSQL database you want to use locally.
  • DATABASE_RLS_URL / DATABASE_BYPASS_RLS_URL / DATABASE_MIGRATION_URL — verify the host, port, and credentials match your local PostgreSQL setup.
  • AUTH_SECRET — a random secret is generated for you, but you can replace it with your own.

Create the database

Run the following to create the database and apply all migrations:

pnpm db:migrate:create

This uses Prisma to set up your PostgreSQL database schema.

Start the dev server

From the root of your project, run:

pnpm dev

This starts both the backend and frontend in development mode with hot reloading:

Start the mobile app

If you're using the mobile app, open a new terminal and run one of the following from the root:

# iOS
pnpm mobile:ios
 
# Android
pnpm mobile:android
Prerequisite installsFile storage (Local)