README.md
February 26, 2026 · View on GitHub
A production-ready Angular 21 starter template with modern tooling, testing, and best practices baked in.
Features
| Category | Tool | Description |
|---|---|---|
| Framework | Angular 21 | Latest Angular with signals, standalone components & new control flow |
| UI | Angular Material | Material Design component library |
| Styling | Tailwind CSS 4 | Utility-first CSS framework |
| Unit Testing | Jest 30 | Fast, reliable unit tests with jest-preset-angular |
| E2E Testing | Playwright | Cross-browser E2E tests (Chromium, Firefox, WebKit) |
| Linting | ESLint 10 | Static analysis with Angular & TypeScript rules |
| Formatting | Prettier | Consistent code formatting |
| i18n | Transloco | Runtime internationalization |
| Documentation | Compodoc | Auto-generated project documentation |
| Component Dev | Storybook 10 | Isolated component development & showcase |
| Bundle Analysis | Source Map Explorer | Visualize bundle size & composition |
| Containerization | Docker | Production-ready Dockerfile |
| Commit Quality | Commitlint + Husky | Enforce conventional commits via Git hooks |
| Security | AuditJS | Dependency vulnerability scanning |
| Changelog | auto-changelog | Automatically generated CHANGELOG |
Quick Start
# Clone the repository
git clone https://github.com/wlucha/angular-starter
cd angular-starter
# Install dependencies
npm install
# Start the development server
npm run start
Open http://localhost:4200 in your browser.
Docker
docker build . -t angular-starter
docker run -p 3000:80 angular-starter
Available Scripts
| Command | Description |
|---|---|
npm run start | Start the dev server on localhost:4200 |
npm run build:prod | Production build with optimizations |
npm run test | Run unit tests with Jest |
npm run test:ci | Run unit tests in CI mode (sequential) |
npm run test:coverage | Run tests with coverage report |
npm run e2e | Run E2E tests with Playwright |
npm run lint | Lint the project with ESLint |
npm run prettier | Format all files with Prettier |
npm run storybook | Launch Storybook on localhost:6006 |
npm run compodoc | Generate documentation with Compodoc |
npm run analyze | Analyze bundle size with Source Map Explorer |
npm run audit | Audit dependencies for vulnerabilities |
Project Structure
angular-starter/
├── src/
│ ├── app/ # Application source code
│ ├── assets/ # Static assets
│ ├── environments/ # Environment configs
│ └── stories/ # Storybook stories
├── tests/ # Playwright E2E tests
├── angular.json # Angular CLI configuration
├── jest.config.ts # Jest configuration
├── playwright.config.ts # Playwright configuration
├── eslint.config.mjs # ESLint flat config
└── tsconfig.json # TypeScript configuration
Demo & Deployment
- Live Demo: Open in StackBlitz
- Deploy to Heroku:
Contributing
Contributions are welcome! Please read the Contribution Guidelines before submitting a PR.
Have a feature request or found a bug? Open an issue.
License
This project is licensed under the MIT License.
If this project helps you, please give it a ⭐ on GitHub!