Installation

Navigator is a Next.js application managed with pnpm.

Requirements

Node.js 20 or newer
pnpm
PostgreSQL, either local or Docker-managed
At least one model provider key
Supabase project if you want avatars, chat attachments, generated images, or knowledge-base uploads

pnpm i

Navigator uses Better Auth. Generate a strong secret and add it to .env.

npx @better-auth/cli@latest secret

BETTER_AUTH_SECRET=your-generated-secret

Use the project helper for a local PostgreSQL container:

pnpm docker:pg

Or point Navigator at an existing database:

POSTGRES_URL=postgres://user:password@host:5432/database

pnpm db:migrate

pnpm dev

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

Script	Purpose
`pnpm dev`	Start the Next.js development server
`pnpm build`	Build for production
`pnpm start`	Run the production build
`pnpm build:local`	Build with local cookie settings
`pnpm test`	Run unit tests
`pnpm test:e2e`	Run Playwright tests
`pnpm check-types`	Run TypeScript checks
`pnpm format`	Format with Biome