Clicker

Ionic 2 Demo / Seed Project : + i18n + Unit Testing + E2E Testing + CI + CD

Click here for the live demo

<p align="center"> <img src="http://lathonez.github.io/images/ionic2_unit_testing/clicker.gif" alt=""/> </p>

Ionic's official repo

Ionic have created an official unit testing example over at driftyco/ionic-unit-testing-example. To understand why this repo still exists, see #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 or newer

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 for more info.

Run Unit Tests

npm test          # run unit tests

Run E2E

npm run webdriver
npm run e2e

Blog Topics

• Unit testing walkthrough
• E2E testing walkthrough
• Removing assets from the APK

Contribute

PRs are welcome, see the roadmap sticky

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

Acks

• This started out as a fork of Angular 2 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 for the advice, help, PRs etc

Changelog

See the changelog here

Updated for:

• @angular/*: 5.0.4
• @angular/cli:: 1.5.4
• @ionic-angular: 3.9.2