Angular Starter

A minimal, scalable Angular starter kit. Standard Angular CLI tooling, zoneless change detection, standalone components, lazy-loaded feature routes, and a modern test/lint stack — nothing else bolted on.

• Angular 21 — standalone components, signals, zoneless change detection, esbuild/Vite-based build (@angular/build)
• Vitest — unit tests
• Playwright — end-to-end tests
• ESLint + Prettier — linting and formatting
• TypeScript strict mode

• Node.js (see .nvmrc; Angular 21 requires Node ^20.19 || ^22.12 || >=24)
• npm

npm install
npm start

Open http://localhost:4200.

New to the codebase? See docs/getting-started.md for a walkthrough of the structure, a worked example (src/app/features/counter/), and how to add a new feature route.

src/app/
  app.ts, app.html, app.scss   # root shell: layout + <router-outlet>
  app.routes.ts                 # top-level route table (lazy-loaded)
  app.config.ts                 # application providers
  features/
    home/                       # one folder per feature
      home.ts
      home.html
      home.spec.ts
      home.routes.ts            # feature's own route table, lazy-loaded from app.routes.ts
    about/
      ...
    counter/                     # worked example: service + signals + reactive form
      ...
e2e/                             # Playwright specs
docs/
  getting-started.md             # walkthrough for new contributors

Each feature is self-contained and lazy-loaded via loadChildren/loadComponent, so the pattern scales by adding new folders under features/ rather than growing a shared module. Add cross-feature code (shared UI, utilities, data access) under src/app/shared/ or src/app/core/ as the app grows — neither exists yet since this is a starter kit and premature structure isn't worth adding until there's a second consumer.

This repo includes AGENTS.md, .claude/CLAUDE.md, and .cursor/rules/ with Angular/TypeScript conventions for AI coding assistants (Claude Code, Cursor, and other tools that read AGENTS.md).