First Run

This page defines what a successful first run looks like.

Day-1 Success Checklist

First Run


pnpm prisma generate

5. Run database migrations

Apply schema migrations to your local database:


pnpm prisma migrate dev

This will:

Create database tables
Apply schema changes
Keep your local DB in sync

(Optional: seed the database if required)


pnpm prisma db seed

Start the development server


pnpm dev

Open the app

Visit http://localhost:3000

Seed Sample Data

⚠️ These endpoints are intended for local development only

Use the following endpoints to populate the application with sample data, including admin and demo users, as well as sample projects, test cases, and test runs.

Seed Sample Data


http://localhost:3000/api/seed

Seed Additional Users


http://localhost:3000/api/users/seed

⚠️ Truncate Database (Danger)

Deletes all data from the database. Use with caution.


http://localhost:3000/api/seed/truncate

sample 2

1) Start dependencies

If using Docker Compose:


docker compose up -d

2) Apply migrations (if not already done)

Use your repo’s canonical scripts. Common examples:


pnpm db:migrate
pnpm db:seed

Or Prisma:


pnpm prisma migrate dev
pnpm prisma db seed

3) Start the dev server


pnpm dev

Open:

http://localhost:3000

4) Log in

Depending on the auth model:

Use the seeded admin/demo user (recommended in dev)
Or sign in via SSO/OAuth using dev credentials

If seeded credentials exist, document them here:

Email: <DEMO_EMAIL>
Password: <DEMO_PASSWORD>

5) Verify one key workflow

Pick one “happy path” that represents the product:

Create a record
Update it
View it in a list/report
Confirm permissions behave as expected

Document the expected result and where to look if it fails (logs, DB, network tab).

6) Prove the dev loop (hot reload)

Make a tiny UI change, e.g. update a heading in a page/component:

Save file
Confirm browser updates without a full restart

7) Run checks


pnpm lint
pnpm test