# Running the Project

> Start the web app, seed data, and run the main verification commands.

*Canonical: https://makerkit.dev/docs/tanstack-prisma/installation/running-the-project*

---

Start required local services first:

```bash
pnpm compose:dev:up
pnpm --filter "@kit/database" prisma:migrate
pnpm seed
pnpm dev
```

The web app runs at `http://localhost:3000`.

## Verification

Useful repo checks:

```bash
pnpm typecheck
pnpm lint:fix
pnpm format:fix
pnpm healthcheck
pnpm test:unit
```

`pnpm healthcheck` does not run unit tests. Run `pnpm test:unit` separately.

## Email Verification During Dev

For sign-up and reset flows:

- use Mailpit at `http://localhost:8025`
- or inspect terminal output for dev email logging where supported

## Useful Commands

```bash
pnpm dev
pnpm compose:dev:up
pnpm compose:dev:down
pnpm run db:reset
pnpm --filter "@kit/database" prisma:generate
pnpm --filter "@kit/database" prisma:migrate
pnpm --filter "@kit/database" prisma:studio
pnpm run stripe:listen
```

---

**Next:** [Updating the Codebase →](./updating-codebase)