Skip to content

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.

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.

  • 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