https://github.com/lathonez/clicker
Ionic 2 + @angular/cli Seed Project : Angular2 + Typescript + Karma + Protractor + Travis
https://github.com/lathonez/clicker
angular-cli e2e-tests ionic seed unit-testing
Last synced: 3 months ago
JSON representation
Ionic 2 + @angular/cli Seed Project : Angular2 + Typescript + Karma + Protractor + Travis
- Host: GitHub
- URL: https://github.com/lathonez/clicker
- Owner: lathonez
- License: mit
- Created: 2015-12-09T00:47:41.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-02-27T19:27:11.000Z (over 2 years ago)
- Last Synced: 2025-03-28T09:09:14.645Z (3 months ago)
- Topics: angular-cli, e2e-tests, ionic, seed, unit-testing
- Language: TypeScript
- Homepage: http://lathonez.com/2018/ionic-2-unit-testing/
- Size: 10.6 MB
- Stars: 430
- Watchers: 38
- Forks: 134
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
## Ionic 2 Demo / Seed Project : + i18n + Unit Testing + E2E Testing + CI + CD
[](https://circleci.com/gh/lathonez/clicker) [](https://ci.appveyor.com/project/lathonez/clicker) [](https://codecov.io/github/lathonez/clicker?branch=master) [](https://codeclimate.com/github/lathonez/clicker) [](http://opensource.org/licenses/MIT) [](https://david-dm.org/lathonez/clicker) [](https://david-dm.org/lathonez/clicker#info=devDependencies)
[Click here for the live demo](http://lathonez.com/clicker)
## Ionic's official repo
Ionic have created an official unit testing example over at [driftyco/ionic-unit-testing-example](https://github.com/driftyco/ionic-unit-testing-example). To understand why this repo still exists, see [#239](https://github.com/lathonez/clicker/issues/239), where we looked at deprecating `clicker` in favour of `ionic-unit-testing-example`.
Broadly, the official example repo:
* Is not mature or production ready
* Is intended as a simple example only / will not be supported by Ionic
* Does not support e2e
* Does not use `@angular/cli` and thus lacks testing support from the wider ng2 community
For ~large or production projects, I suggest using clicker. For small apps / side projects the official example should suffice.
## Install & Start
You need to be running [the latest node LTS](https://nodejs.org/en/download/) or newer
```bash
git clone https://github.com/lathonez/clicker.git
cd clicker
npm install
npm start # start the application (ionic serve)
```
Running as root? You probably shouldn't be. If you need to: `npm run postinstall` before `npm start`. [#111](https://github.com/lathonez/clicker/issues/111) for more info.
## Run Unit Tests
```bash
npm test # run unit tests
```
## Run E2E
```
npm run webdriver
npm run e2e
```
## Blog Topics
* [Unit testing walkthrough](http://lathonez.com/2018/ionic-2-unit-testing/)
* [E2E testing walkthrough](http://lathonez.com/2018/ionic-2-e2e-testing/)
* [Removing assets from the APK](http://lathonez.com/2016/cordova-remove-assets/)
## Contribute
PRs are welcome, see the [roadmap sticky](https://github.com/lathonez/clicker/issues/38)
## Help
* If you can't get the testing working, raise an issue
* If you have a general question about unit testing (e.g. how can I write a unit test for `some-module`), see [#191](https://github.com/lathonez/clicker/issues/191)
## Acks
* This started out as a fork of [Angular 2 Seed](https://github.com/mgechev/angular2-seed) and would not be possible without it
* @stonelasey for i18n (#271)
* @bengro for the lightweightify inspiration (#68)
* @ric9176 and @DanielaGSB for E2E tests (#50)
* @tja4472 for the ngrx implementation (#133)
* [Everyone else](https://github.com/lathonez/clicker/graphs/contributors) for the advice, help, PRs etc
## Changelog
See the changelog [here](https://github.com/lathonez/clicker/blob/master/CHANGELOG.md)
## Updated for:
* **@angular/*:** 5.0.4
* **@angular/cli:**: 1.5.4
* **@ionic-angular:** 3.9.2