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.
-
Run
npm ci
to install everything -
Run
npm run add [your-library-name]
to create basic file structure -
Fill in
projects/[your-library-name]/package.json
metadata for your newly generated library -
Add your email at [INSERT YOUR EMAIL HERE] in
CODE_OF_CONDUCT.md
-
Update
LICENSE
file according to your preferences -
Updated root
package.json
metadata to represent your project -
Code your library and create demo for it
-
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
ornpm run prerender
-
CI and code coverage are ready, Github Action checks that packages build, test and lint correctly. It also sends test results to Coveralls.
-
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.
This starter uses Angular 9. This way your libraries will be supported across all Angular versions in Ivy world.
If you need to support older versions of Angular like 6 and above, you can use tag view-engine
of this repository as
your starting point as it is running Angular 7.
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/TinkoffCreditSystems/angular-open-source-starter)