Deep DivesWeb

Development

Local development guide for the RawStack Web component.

Setup

cd apps/web
npm install
cp .env.example .env.local
npm run dev

The app is available at http://localhost:3000 with Turbopack hot reload.

Project structure

apps/web/
├── app/                  # Next.js App Router — layouts, pages, loading states
├── components/           # Shared React components
├── lib/                  # API helpers, utilities, hooks
├── public/               # Static assets
├── specs/                # Feature specs / documentation
├── next.config.ts
├── tailwind.config.ts
├── vitest.config.ts
└── Dockerfile

Useful scripts

ScriptDescription
npm run devStart Turbopack dev server
npm run buildProduction build
npm run startRun production build
npm run lintESLint
npm run testVitest watch mode
npm run test:runSingle test run
npm run test:e2ePlaywright E2E tests

Regenerating the API client

When the API schema changes, regenerate the shared client from the repo root:

./scripts/generate-api-client.sh

Then rebuild the web app to pick up the updated types.

Tech Specification

Technical specification for the RawStack Web component.

Testing

Testing guide for the RawStack Web component.

On this page

SetupProject structureUseful scriptsRegenerating the API client