Home

Awesome

Groceries Build Status

Groceries is a NativeScript-built iOS and Android app for managing grocery lists. You can learn how to build a version of this app from scratch using either our JavaScript getting started guide, or our TypeScript and Angular getting started guide.

<!-- * [Download](#download) --> <h2 id="screenshots">Screenshots</h2>

<h2 id="development">Development</h2>

This app is built with the NativeScript CLI. Once you have the CLI installed, start by cloning the repo:

$ git clone https://github.com/NativeScript/sample-Groceries.git
$ cd sample-Groceries

From there you can use the run command to run Groceries on iOS:

$ tns run ios

And the same command to run Groceries on Android:

$ tns run android
<h3 id="linting">Linting</h3>

Groceries uses tslint + codelyzer rules to ensure the code follows the angular style guide.

You can run the linter with the tslint npm script:

$ npm run tslint
<h3 id="unit-testing">Unit Testing</h3>

Groceries uses NativeScript’s integrated unit test runner with Jasmine. To run the tests for yourself use the tns test command:

$ tns test ios --emulator
$ tns test android --emulator

For more information on unit testing NativeScript apps, refer to the NativeScript docs on the topic.

<h3 id="travis">Travis CI</h3>

Groceries uses Travis CI to verify all tests pass on each commit. Refer to the .travis.yml configuration file for details.

<h2 id="contributors">Contributors</h2>

The following is a list of all the people that have helped build Groceries. Thanks for your contributions!

<img alt="tjvantoll" src="https://avatars.githubusercontent.com/u/544280?v=3&s=117" width="117"><img alt="hdeshev" src="https://avatars.githubusercontent.com/u/63219?v=3&s=117" width="117"><img alt="vakrilov" src="https://avatars.githubusercontent.com/u/4092076?v=3&s=117" width="117"><img alt="Mitko-Kerezov" src="https://avatars.githubusercontent.com/u/6683316?v=3&s=117" width="117"><img alt="jlooper" src="https://avatars.githubusercontent.com/u/1450004?v=3&s=117" width="117"><img alt="rosen-vladimirov" src="https://avatars.githubusercontent.com/u/8351653?v=3&s=117" width="117">

<img alt="SvetoslavTsenov" src="https://avatars.githubusercontent.com/u/3598759?v=3&s=117" width="117"><img alt="ligaz" src="https://avatars.githubusercontent.com/u/19437?v=3&s=117" width="117"><img alt="sis0k0" src="https://avatars.githubusercontent.com/u/7893485?v=3&s=117" width="117"><img alt="wdulin" src="https://avatars.githubusercontent.com/u/1111372?v=3&s=117" width="117"><img alt="dtopuzov" src="https://avatars.githubusercontent.com/u/6651651?v=3&s=117" width="117"><img alt="nadyaA" src="https://avatars.githubusercontent.com/u/6064810?v=3&s=117" width="117">

<img alt="vchimev" src="https://avatars.githubusercontent.com/u/12251337?v=3&s=117" width="117"><img alt="covex-nn" src="https://avatars.githubusercontent.com/u/110878?v=3&s=117" width="117"><img alt="bundyo" src="https://avatars.githubusercontent.com/u/98318?v=3&s=117" width="117"><img alt="EddyVerbruggen" src="https://avatars.githubusercontent.com/u/1426370?v=3&s=117" width="117"><img alt="NathanWalker" src="https://avatars.githubusercontent.com/u/457187?v=3&s=117" width="117"><img alt="nsndeck" src="https://avatars.githubusercontent.com/u/5665150?v=3&s=117" width="117">

<img alt="tzraikov" src="https://avatars.githubusercontent.com/u/3244426?v=3&s=117" width="117"><img alt="TsvetanMilanov" src="https://avatars.githubusercontent.com/u/10463529?v=3&s=117" width="117"><img alt="bradmartin" src="https://avatars.githubusercontent.com/u/6006148?v=3&s=117" width="117"><img alt="cmelo" src="https://avatars.githubusercontent.com/u/872461?v=3&s=117" width="117">

<!-- Note: The table above get generated with the following commands --> <!-- npm install -g github-contributors-list --> <!-- githubcontrib --owner NativeScript --repo sample-Groceries --cols 6 --sortOrder desc | pbcopy -->

Big Thanks

Cross-browser Testing Platform and Open Source Provided by Sauce Labs.

<img alt="SauceLabs" src="assets/sauceLabs/SauceLabs-white.svg" width="200">