Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pablodenadai/angular2-seed-project
[DEPRECATED] Angular 2 Seed Project – Gulp, TypeScript, Typings, Karma, Protractor, Sass and more.
https://github.com/pablodenadai/angular2-seed-project
Last synced: 16 days ago
JSON representation
[DEPRECATED] Angular 2 Seed Project – Gulp, TypeScript, Typings, Karma, Protractor, Sass and more.
- Host: GitHub
- URL: https://github.com/pablodenadai/angular2-seed-project
- Owner: pablodenadai
- License: mit
- Created: 2015-12-06T18:16:56.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2016-05-16T08:52:06.000Z (over 8 years ago)
- Last Synced: 2024-04-10T09:12:19.608Z (7 months ago)
- Language: JavaScript
- Homepage: http://angular2-seed.io/
- Size: 1.62 MB
- Stars: 114
- Watchers: 14
- Forks: 39
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
## DEPRECATED
Alternatives:
- Angular 2 Official CLI: [https://cli.angular.io/](https://cli.angular.io/)
- Angular 2 Official Seed: [https://github.com/angular/angular2-seed](https://github.com/angular/angular2-seed)# Angular 2 - Seed Project
[![Build Status](https://travis-ci.org/ghpabs/angular2-seed-project.svg?branch=master)](https://travis-ci.org/ghpabs/angular2-seed-project)
[![Join the chat at https://gitter.im/ghpabs/angular2-seed-project](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/ghpabs/angular2-seed-project)## Stack
- [Gulp 4](http://gulpjs.com/)
- [Angular 2](https://angular.io/)
- [TypeScript](http://www.typescriptlang.org/)
- [Typings](https://github.com/typings/typings)
- [Sass](http://sass-lang.com/)
- [Karma](http://karma-runner.github.io/)
- [Protractor](http://www.protractortest.org/)## Workflow Features
- **Gulp** fully automated workflow.
- **Development** and **production** environment targets.
- **Unit** and **E2E** test samples.
- **Code coverage** report with TypeScript mapping.
- **TypeScript** definition manager, linting, sourcemaps and transpilation (ES5).
- **Sass** linting, sourcemaps and transpilation.
- **TypeDoc** documentation generator.
- **Change Log** generated based on Git metadata.## Angular 2 Features
- Directives
- Pipes
- Services
- Router
- REST API
- Template Cache
- Modular Components
- Dependency Injection
- Custom Events## Global Dependencies
| Dependency | Version | Install |
| ---------- | ------- | ------------------------------------- |
| NodeJS | 5.x.x | [http://node.org](http://nodejs.org/) |
| npm | 3.x.x | [http://node.org](http://nodejs.org/) |
| Gulp CLI | 0.4.x | `npm install gulpjs/gulp-cli#4.0 -g` |
| Typings | 0.6.x | `npm install typings -g` |## Install
```
$ git clone https://github.com/ghpabs/angular2-seed-project.git && cd angular2-seed-project
$ npm install
$ typings install
$ gulp build serve
```Note: the `serve` task won't automatically launch the browser for you.
To view the app please open a new tab and go to `http://localhost:8080/`.## Usage
### Tasks
- `$ gulp clean`: Remove generated folders - `build`, `docs` and `coverage`.
- `$ gulp unit`: Run Karma against all `src/scripts/**/*.spec.js` files.
- `$ gulp e2e`: Run Protractor against all `e2e/**/*.spec.js` files. The project must be being served before running end-to-end tests.
- `$ gulp build`: Create distribution package.
- `$ gulp serve`: Start web-server and live-reload.
- `$ gulp docs`: Generate documentation.
- `$ gulp changelog`: Generate `CHANGELOG.md` file from Git metadata. See [Change Log](#change-log) for more info.### Environments
Default: `NODE_ENV=development` and `PORT=8080`.#### Development:
- `$ gulp build serve` is equivalent to
`$ NODE_ENV=development PORT=8080 gulp build serve`.#### Production
- `$ NODE_ENV=production gulp build serve`.## Ecosystem
You might have noticed that we have quite a few files in our `root` folder. You might also be wondering why we need them and whether they are applicable to your use case. Here is a brief explanation:- **.travis.yml**: Travis is our Continuous Integration (CI) server and this is its configuration file. We have added hooks to GitHub so automated tests will kick in after each commit.
- **karma.shim.js**: Unit testing Angular2 apps is still in its early days and this file helps us setup the test runner - Karma.## Change Log
This project generates the `CHANGELOG.md` from Git metadata using the [conventional-changelog](https://github.com/ajoslin/conventional-changelog) library. The commit message must follow the [Angular conventions][angular-commit-message-format] for this feature to work.### Recommended Workflow
- Make changes
- Commit those changes
- Make sure Travis turns green
- Bump version in `package.json`
- Run `gulp changelog`
- Commit `package.json` and `CHANGELOG.md` files
- Tag
- Push## Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. When submitting a PR, make sure that the commit messages match the [Angular conventions][angular-commit-message-format].## License
MIT[angular-commit-message-format]: https://github.com/angular/angular/blob/master/CONTRIBUTING.md#commit-message-format