Skip to content

lathonez/clicker

Repository files navigation

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

CircleCI Build status codecov.io Code Climate MIT license Dependency Status devDependency Status

Click here for the live demo

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

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