The Application

The app lives in the web/ directory. It starts as a bare skeleton, just enough structure for Claude to begin building. By the end of a session it's a complete, production-ready application.

Technology

Stadium 8 applications are built on a fixed, modern stack:

• Next.js 16 with the App Router

• React 19

• TypeScript 5 (strict mode: no any, no shortcuts)

• Tailwind CSS 4 for styling

• shadcn/ui for UI components

• Authentication configured per project during Intake — BFF (recommended), frontend-only via Next-Auth, or custom. No auth library is bundled by default.

• Vitest and React Testing Library for unit and integration tests

• Playwright for end-to-end browser tests

• GitHub Actions for CI/CD with five quality gates

The application uses strict TypeScript throughout. Claude doesn't cut corners on types. Every component, function, and API call is fully typed.

What the Application Includes

• Full implementation of every epic and story you approved

• Unit and integration tests for every story, written before the code they cover

• End-to-end Playwright tests run against each story as it is built

• A mock backend that mirrors your real backend's API shape, if you provided an OpenAPI spec. Swappable via NEXT_PUBLIC_API_BASE_URL

• Environment configuration via .env.example so setup is straightforward for anyone who clones the repo