Next Forge — Enterprise Reference Architecture

Next Forge is a world-class open-source Next.js Enterprise Reference Architecture built to demonstrate how modern production frontend applications should be architected, tested, governed, and maintained.

Key Features

• Monorepo Architecture: pnpm workspaces and Turborepo setup (apps/, packages/, tooling/).
• Architectural Boundaries: Automated ESLint boundary rules preventing layer leaks and circular dependencies.
• Application Kernel: @repo/core infrastructure powering telemetry, API clients, TanStack Query, and RBAC auth.
• Standalone Design System: Accessible UI components in @repo/ui styled with CSS custom properties.
• Bounded Context Modules: Feature-driven domain architecture (dashboard, users, settings, auth).
• Multi-Tiered Testing: Native ESM Vitest unit/component suites and Playwright E2E standards.

Quick Start

# Install dependencies
pnpm install

# Run dev server
pnpm run dev

# Run unit and component test suite
pnpm test

# Run typecheck and linting
pnpm run typecheck && pnpm run lint

Documentation

• Architecture Handbook
• Layer Rules & Boundaries
• Architectural Decision Records (ADRs)