Angular Open-source Starter

How to use

This is a starter project for creating open-source libraries for Angular. It is a full-fledged Angular workspace with demo application and easy library addition. It is designed to be used for open-sourcing libraries on GitHub and has everything you'd need ready for CI, code coverage, SSR testing, StackBlitz demo deployment and more.

1. Run npm ci to install everything

2. Run npm run add [your-library-name] to create basic file structure

3. Fill in projects/[your-library-name]/package.json metadata for your newly generated library

4. Add your email at [INSERT YOUR EMAIL HERE] in CODE_OF_CONDUCT.md

5. Update LICENSE file according to your preferences

6. Updated root package.json metadata to represent your project

7. Code your library and create demo for it

Cool features

• Versioning is ready for you with following simple commands:

{
  "release": "standard-version",
  "release:patch": "npm run release -- --release-as patch",
  "release:minor": "npm run release -- --release-as minor",
  "release:major": "npm run release -- --release-as major",
  "publish": "npm run build:all && npm publish:all"
}

Just use Conventional Commits format and CHANGELOG.md will be automatically generated on releases by Standard Version.

• This project has Angular Universal — you can easily test your library with SSR and Prerender:

  npm run dev:ssr or npm run prerender

• CI and code coverage are ready, GitHub Action checks that packages build, test and lint correctly. It also sends test results to Codecov.

• Precommit checks, prettier, linter and all that jazz is there.

• You can also deploy your demo to StackBlitz with no hustle, just use link in the following format:

     https://stackblitz.com/github/[User|Organization]/[Repository]/tree/main/projects/demo
  

• You can add more libraries using the same npm run add command to create a whole Angular Workspace with multiple libraries. Versioning and publishing is configured that they are released simultaneously like Angular packages.

Infrastructure

• GitHub Actions
• Node.js 16+, npm 8+
• Angular 12+
• TypeScript 4+
• Prettier 2.6+
• Stylelint 14+
• ESLint 7+
• Husky 7+
• Cypress 9+
• Jest 27+
• Nx 13+

Badge

Show that your project is based off of our starter

[![angular-open-source-starter](https://img.shields.io/badge/made%20with-angular--open--source--starter-d81676?logo=angular)](https://github.com/Tinkoff/angular-open-source-starter)