Getting Started

This page helps developers run the web app on their own machine. It covers the tools you need, the setup steps, and the daily commands.

Who this page is for

This page targets developers. Business analysts and clients can skip to the feature guides.

What you need first

Install these tools before you start:

git clone https://github.com/supportkings/national-commerce.git
cd national-commerce

pnpm install

pnpm installs every workspace at once. The repo uses Turborepo to link the apps and packages together.

Create apps/web/.env.local and set your Supabase keys:

NEXT_PUBLIC_SUPABASE_URL=your-supabase-url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-supabase-anon-key

The app reads these keys to reach the database and sign users in.

Link your local checkout to the Supabase project:

supabase login
supabase link --project-ref axzbddunsdtgjpnycprb
supabase db pull

supabase db pull copies the remote schema to your machine.

Start every app in the monorepo:

pnpm dev

Or start only the web app:

cd apps/web && pnpm dev

The web app runs on Next.js with Turbopack. Open the printed local URL to view it.

Use these commands as you work.

cd apps/web && pnpm typecheck

Biome lints fast when you target one file:

npx biome check --write apps/web/components/file.tsx

Never lint the whole repo at once

Global Biome commands such as pnpm lint time out. Always lint file by file.

pnpm build

If the build runs out of memory, raise the limit:

NODE_OPTIONS="--max-old-space-size=8192" pnpm build

Regenerate the TypeScript types after you change the schema:

npx supabase gen types typescript --project-id axzbddunsdtgjpnycprb > packages/supabase/src/types/supabase.ts

Always import types from packages/supabase/src/types/supabase.ts. Never use the any type.