https://github.com/thisissoon/angular-starter
An example Angular project by SOON_
https://github.com/thisissoon/angular-starter
angular ci components lazy-loading linting pipes prettier services starter starter-project stylelint testing tslint universal
Last synced: 2 months ago
JSON representation
An example Angular project by SOON_
- Host: GitHub
- URL: https://github.com/thisissoon/angular-starter
- Owner: thisissoon
- License: mit
- Created: 2014-10-08T17:17:14.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2018-04-24T16:53:54.000Z (over 7 years ago)
- Last Synced: 2024-04-13T23:54:43.537Z (over 1 year ago)
- Topics: angular, ci, components, lazy-loading, linting, pipes, prettier, services, starter, starter-project, stylelint, testing, tslint, universal
- Language: TypeScript
- Homepage:
- Size: 438 KB
- Stars: 4
- Watchers: 11
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Angular Starter
[](https://circleci.com/gh/thisissoon/angular-starter)
[](https://coveralls.io/github/thisissoon/angular-starter?branch=master)
An example Angular project by SOON\_
This project was generated with [Angular CLI](https://github.com/angular/angular-cli) version 1.7.4.
## Development server
Run `ng serve` for a dev server. Navigate to `http://localhost:4200/`. The app will automatically reload if you change any of the source files.
## Code scaffolding
Run `ng generate component component-name` to generate a new component. You can also use `ng generate directive|pipe|service|class|guard|interface|enum|module`.
## Build
Run `ng build` to build the project. The build artifacts will be stored in the `dist/` directory. Use the `-prod` flag for a production build.
## Running unit tests
Run `ng test` to execute the unit tests via [Karma](https://karma-runner.github.io).
## Running end-to-end tests
Run `ng e2e` to execute the end-to-end tests via [Protractor](http://www.protractortest.org/).
## Further help
To get more help on the Angular CLI use `ng help` or go check out the [Angular CLI README](https://github.com/angular/angular-cli/blob/master/README.md).
## Making Commits
This repo uses [Commitizen CLI](http://commitizen.github.io/cz-cli/) and [Conventional Changelog](https://github.com/conventional-changelog/conventional-changelog) to create commits and generate changelogs. Instead of running `git commit` run `git cz` and follow the prompts. Changelogs will then be generated when creating new releases by running `npm run release`.
## Making Releases
Run `npm run release` to create a new release. This will use [Standard Version](https://github.com/conventional-changelog/standard-version) to create a new release. [Standard Version](https://github.com/conventional-changelog/standard-version) will generate / update the changelog based on commits generated using [Commitizen CLI](http://commitizen.github.io/cz-cli/), update the version number following semantic versioning rules and then commit and tag the commit for the release. Simply run `git push --follow-tags origin master`.
## Server side rendering
The app can be rendered on a server before serving pages to the client. Server side rendering is achieved using [Express](https://expressjs.com/) and [Angular Universal](https://github.com/angular/universal) with [Express](https://expressjs.com/) running a [node](https://nodejs.org/en/) web server and [@nguniversal/express-engine](https://github.com/angular/universal/tree/master/modules/express-engine) providing a template engine for [Express](https://expressjs.com/) to render the angular pages.
Run `npm run build:ssr && npm run serve:ssr` to build client and server bundles and run an express app which will render the angular templates before being sent to the client. Navigate to `http://localhost:4000/` to view the SSR version of the app.