{"id":20857171,"url":"https://github.com/walkingriver/ng-cordova","last_synced_at":"2025-03-12T13:44:04.143Z","repository":{"id":150469056,"uuid":"47760645","full_name":"walkingriver/ng-cordova","owner":"walkingriver","description":"An Ionic Framework app to showcase various ngCordova wrappers.","archived":false,"fork":false,"pushed_at":"2015-12-10T13:10:31.000Z","size":99,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-19T07:13:27.295Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/walkingriver.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-12-10T12:35:01.000Z","updated_at":"2015-12-10T13:10:32.000Z","dependencies_parsed_at":"2023-04-15T13:44:10.347Z","dependency_job_id":null,"html_url":"https://github.com/walkingriver/ng-cordova","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/walkingriver%2Fng-cordova","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/walkingriver%2Fng-cordova/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/walkingriver%2Fng-cordova/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/walkingriver%2Fng-cordova/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/walkingriver","download_url":"https://codeload.github.com/walkingriver/ng-cordova/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243230060,"owners_count":20257640,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-18T04:36:40.097Z","updated_at":"2025-03-12T13:44:04.118Z","avatar_url":"https://github.com/walkingriver.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ngCordova\nThis project was generated with Generator-M-Ionic v1.4.1. For more info visit the [repository](https://github.com/mwaylabs/generator-m-ionic) or check out the README below.\n\n# Generator-M-Ionic v1.4.1\n\n[![NPM version](http://img.shields.io/npm/v/generator-m-ionic.svg?style=flat-square)][npm-url]\n[![Coverage Status](http://img.shields.io/coveralls/mwaylabs/generator-m-ionic/master.svg?style=flat-square)][coveralls-url]\n[![Build Status](https://img.shields.io/travis/mwaylabs/generator-m-ionic/master.svg?style=flat-square)][travis-url]\n[![Dependency Status](http://img.shields.io/david/mwaylabs/generator-m-ionic/master.svg?style=flat-square)][daviddm-url]\n[![Download Month](http://img.shields.io/npm/dm/generator-m-ionic.svg?style=flat-square)][npm-url]\n\n[npm-url]: https://npmjs.org/package/generator-m-ionic\n[coveralls-url]: https://coveralls.io/r/mwaylabs/generator-m-ionic?branch=master\n[travis-url]: https://travis-ci.org/mwaylabs/generator-m-ionic\n[daviddm-url]: https://david-dm.org/mwaylabs/generator-m-ionic\n\nDevelopment:\n\n[![Dev Coverage Status](http://img.shields.io/coveralls/mwaylabs/generator-m-ionic/dev.svg?style=flat-square)][coveralls-url]\n[![Dev Build Status](https://img.shields.io/travis/mwaylabs/generator-m-ionic/dev.svg?style=flat-square)][travis-url]\n[![Dev Dependency Status](http://img.shields.io/david/mwaylabs/generator-m-ionic/dev.svg?style=flat-square)](https://david-dm.org/mwaylabs/generator-m-ionic/dev)\n\n## Why you need it\nBuild mobile Cordova/PhoneGap apps quickly with the tools you love:\nYeoman, Gulp, Bower, AngularJS, Ionic \u0026 of course Cordova. All in one sexy generator.\n\n### What's in the box\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"http://yeoman.io/\" target=\"_blank\" alt=\"yeoman\" title=\"yeoman\"\u003e\n    \u003cimg height=\"100\" src=\"https://cloud.githubusercontent.com/assets/1370779/6041228/c1f91cac-ac7a-11e4-9c85-1a5298e29067.png\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"http://gulpjs.com/\" target=\"_blank\" alt=\"gulp\" title=\"gulp\"\u003e\n    \u003cimg height=\"100\" src=\"https://cloud.githubusercontent.com/assets/1370779/9409728/c5332474-481c-11e5-9a6e-74641a0f1782.png\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"http://bower.io/\" target=\"_blank\" alt=\"bower\" title=\"bower\"\u003e\n    \u003cimg height=\"100\" src=\"https://cloud.githubusercontent.com/assets/1370779/6041250/ef9a78b8-ac7a-11e4-9586-7e7e894e201e.png\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://angularjs.org/\" target=\"_blank\" alt=\"angular\" title=\"angular\"\u003e\n    \u003cimg height=\"100\" src=\"https://cloud.githubusercontent.com/assets/1370779/6041199/5978cb96-ac7a-11e4-9568-829e2ea4312f.png\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"http://ionicframework.com/\" target=\"_blank\" alt=\"ionic\" title=\"ionic\"\u003e\n    \u003cimg height=\"100\" src=\"https://cloud.githubusercontent.com/assets/1370779/6041296/59c5717a-ac7b-11e4-9d5d-9c5232aace64.png\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"http://cordova.apache.org/\" target=\"_blank\" alt=\"cordova\" title=\"cordova\"\u003e\n    \u003cimg height=\"100\" src=\"https://cloud.githubusercontent.com/assets/1370779/6041269/20ed1196-ac7b-11e4-8707-68fa331f1aeb.png\"\u003e\n  \u003c/a\u003e\n  \u003cbr\u003e\n  \u003cbr\u003e\n  \u003ca href=\"http://sass-lang.com/\" target=\"_blank\" alt=\"sass\" title=\"sass\"\u003e\n    \u003cimg height=\"100\" src=\"https://cloud.githubusercontent.com/assets/1370779/9410121/c330a3de-481e-11e5-8a69-ca0c56f6cabc.png\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"http://karma-runner.github.io/\" target=\"_blank\" alt=\"karma\" title=\"karma\"\u003e\n    \u003cimg height=\"100\" src=\"https://cloud.githubusercontent.com/assets/1370779/9410216/44fef8fc-481f-11e5-8037-2f7f03678f4c.png\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"http://jasmine.github.io/\" target=\"_blank\" alt=\"jasmine\" title=\"jasmine\"\u003e\n    \u003cimg height=\"100\" src=\"https://cloud.githubusercontent.com/assets/1370779/9410153/ebd46a00-481e-11e5-9864-f00fa8427d17.png\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://angular.github.io/protractor/#/\" target=\"_blank\" alt=\"protractor\" title=\"protractor\"\u003e\n    \u003cimg height=\"100\" src=\"https://cloud.githubusercontent.com/assets/1370779/9410114/b99aaa9a-481e-11e5-8655-ebc1e324200d.png\"\u003e\n  \u003c/a\u003e\n\n\u003c/p\u003e\nWe provide:\n\n- **yeoman** to scaffold your app - http://yeoman.io/\n- **gulp** to run your tasks - http://gulpjs.com/\n- **bower** to manage your client packages - http://bower.io/\n\nthe following **technology stack**:\n\n- **angular** for app structure \u0026 logic - https://angularjs.org/\n  - **angular-ui-router** - https://github.com/angular-ui/ui-router\n- **ionic** for mobile UIs - http://ionicframework.com/\n- **cordova** for accessing phone APIs - http://cordova.apache.org/\n  - **ngCordova** - http://ngcordova.com/\n- **sass** for styling - http://sass-lang.com/\n\n\nan integrated **testing workflow** with:\n\n- **karma** to run your unit tests - http://karma-runner.github.io/\n- **jasmine** for writing unit \u0026 integration tests - http://jasmine.github.io/\n- **protractor** for running and writing integration tests - https://angular.github.io/protractor/#/\n\nand many many **features and tools** for your convenience:\n\n- powerful collection of [gulp tasks](https://github.com/mwaylabs/generator-m-ionic#more-gulp-tasks)\n- broad selection of [sub-generators](https://github.com/mwaylabs/generator-m-ionic#sub-generators)\n- fine tuned [integration with git](https://github.com/mwaylabs/generator-m-ionic#git-integration)\n- sensible defaults for:\n  - continuous integration with [Travis CI](https://travis-ci.org/) and [Jenkins CI](https://jenkins-ci.org/)\n  - code style checks with [ESLint](http://eslint.org/)\n  - configuration files like [.editorconfig](http://editorconfig.org/), [.gitignore](http://git-scm.com/docs/gitignore), [.gitattriubtes](http://git-scm.com/docs/gitattributes) and others\n\n\n## Try the demo\nFor a quick impression head over to https://github.com/mwaylabs/generator-m-ionic-demo and clone the sample project generated with the latest version of Generator-M-Ionic.\n\n\n## Questions? Talk to us!\n[![Join the chat at https://gitter.im/mwaylabs/generator-m-ionic](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/mwaylabs/generator-m-ionic?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n\n## Install\n\n### Prerequisites\n- Installation and **fair knowledge** of:\n- node \u0026 npm - http://nodejs.org/download/\n  - yo: `npm install --global yo` - http://yeoman.io/\n  - gulp: `npm install --global gulp` - http://gulpjs.com/\n  - bower: `npm install --global bower` - http://bower.io/\n- In order to run your app on a device, you'll need:\n  - **Platform SDKs** for the ones you are developing for. Head over to cordova documentation: [Platform Guides](http://cordova.apache.org/docs/en/edge/guide/platforms/index.html) or cordova cli: [Requirements](https://github.com/apache/cordova-cli/#requirements)\n\n### Generator\n\n```sh\nnpm install --global generator-m-ionic\n```\n\n\n## Generate App\n**create new directory** - and cd into it.\n```sh\nmkdir myApp \u0026\u0026 cd $_\n```\n**run the generator** - and follow the instructions\n```sh\nyo m-ionic\n```\n**IMPORTANT:** Cordova needs an empty directory to work. Please run any other setup (e.g. `git init`) after running `yo m-ionic`.\n\n## Get started\n#### gulp watch\nPrepares everything for development and opens your default browser. Get ready to start coding!\n```sh\ngulp watch\n```\nLivereloads your application when changing/adding/deleting files to immediately reflect the changes you make. If you don't want this task to open your browser, just add the `--no-open` option and navigate to `http://localhost:9000` yourself. For your convenience any occurring **ESLint or jsonlint errors** will be presented to you on every livereload.\n\n#### File structure\n\u003cpre\u003e\n└──  app/           - your application folder\n│   └──  bower_components/    - local installation of bower packages\n│   └──  main/                - ---main module---\n│   │   ├──  assets/          - assets: fonts, images, translation, etc... goes here\n│   │   ├──  constants/       - angular constants\n│   │   ├──  controllers/     - angular controllers\n│   │   ├──  directives/      - angular directives\n│   │   ├──  filters/         - angular filters\n│   │   ├──  services/        - angular services\n│   │   ├──  styles/          - scss styles\n│   │   ├──  templates/       - angular templates\n│   │   └──  main.js          - angular module definition, routing etc...\n│   └──  anotherModule/       - ---another  module---\n│   │   ├──  ...\n│   ├──  app.js               - application module, includes main module, ionic, ui-router etc ...\n│   └──  index.html           - angular entry point, injects: app files, bower files, fonts,  ...\n├──  gulp/    - gulp tasks\n├──  hooks/         - cordova hooks\n├──  nodes_modules/ - local installation of node modules\n├──  platforms/     - cordova platforms\n├──  plugins/       - corodova plugins\n├──  res/           - resources folder for splash screens and app icons\n├──  test/          - unit and integration tests\n├──  www/           - your gulp build goes here, cordova starts building from here\n├──  .bowerrc       - bower configuration\n├──  .editorconfig  - editor configuration\n├──  .eslintrc      - ESLint configuration\n├──  .gitattributes - git's attribute configuration\n├──  .gitignore     - git's ignore configuration\n├──  .travis.yml    - travis continuous integration configuration\n├──  .yo-rc.json    - yeoman's .yo-rc.json\n├──  bower.json     - bower dependencies\n├──  config.xml     - cordova's config.xml\n├──  gulpfile.js    - entry point to all gulp tasks\n├──  jenkins.sh     - shell script for jenkins continuous integration\n├──  package.json   - node dependencies configuration\n├──  README.md      - the generator's README.md\n\u003c/pre\u003e\n\n## Testing\nWhen setting up your project or using the module, controller, service, directive or filter sub-generator, Generator-M-Ionic will automatically generate sample test files for that component. These files can be found in the `test/karma` and `test/protractor` directory respectively. To check if all tests are running properly run:\n\n```sh\ngulp karma\n# and\ngulp protractor\n```\n**Hint**: `gulp watch` and `gulp protractor` cannot be run at the same time.\n\nIf you are new to testing your app with protractor, karma and jasmine. Here are some good places to get started:\n\nArticles on **testing angular**\n- AngularJS Developer Guide - [Unit Testing](https://docs.angularjs.org/guide/unit-testing)\n- Smashing Magazine - [Unit Testing In AngularJS](http://www.smashingmagazine.com/2014/10/introduction-to-unit-testing-in-angularjs/)\n  - careful: uses mocha, chai \u0026 sinon but we use jasmine. Still worth a look!\n\n**jasmine** website - http://jasmine.github.io/\n\n**protractor** website - http://angular.github.io/protractor/#/\n\n**karma** website - http://karma-runner.github.io/\n\n\n## Guides\n- Setting up and working with [ESLint](https://github.com/mwaylabs/generator-m-ionic/tree/master/docs/guides/eslint.md)\n- Working with our [SASS integration](https://github.com/mwaylabs/generator-m-ionic/tree/master/docs/guides/sass_integration.md)\n- Using Ionic [CSS or SASS](https://github.com/mwaylabs/generator-m-ionic/tree/master/docs/guides/ionic_css_or_sass.md)\n- Managing app [icons and splash screens](https://github.com/mwaylabs/generator-m-ionic/tree/master/docs/guides/icons_splash_screens.md). Good for different app configurations (beta, production, ...).\n- The contents of the [`config.xml` can be changed programmatically](https://github.com/mwaylabs/generator-m-ionic/tree/master/docs/guides/programmatically_change_configxml.md). Good for continuous integration.\n\n## More gulp tasks\n\n#### gulp --cordova 'run any command'\nA local wrapper for cordova cli (allows to use different cordova CLI versions in different projects). For instance instead of running `cordova plugins ls` you'd write the following to list all the installed plugins:\n```sh\ngulp --cordova 'plugin ls'\n```\nHead over to the [cordova cli documentation](http://cordova.apache.org/docs/en/edge/guide/cli/index.html) or their [github page](https://github.com/apache/cordova-cli/) to learn how to use the cordova cli. Remember that when using Generator-M-Ionic you don't need to install cordova globally!\n\n#### gulp --cordova 'build-related task'\n\nIf you run one of the following cordova commands: `build \u003cplatform\u003e`, `run \u003cplatform\u003e`, `emulate \u003cplatform\u003e`, 'serve' or `prepare \u003cplatform\u003e`, `gulp build` will build your app into the www folder, before cordova will take it from there. For instance if you want to test your app on your connected ios device, run:\n```sh\ngulp --cordova 'run ios' # runs gulp build, then cordova run ios\n```\nSometimes you don't want `gulp build` to run every time before the cordova command is run. In that case simply add the `--no-build` option and `gulp build` will be skipped.\n\n\n#### gulp watch-build\nBuilds into www, watches version in www and opens your browser. Good for debugging and testing your build!\n```sh\ngulp watch-build\n```\nAdd the `--no-build` option and `gulp build` will be skipped.\nThe `--no-open` options is available here as well, in case you don't want your browser to open automatically and would rather navigate to `http://localhost:9000` yourself.\n\n\n#### gulp build\nBuilds your angular app and moves it to the www folder. Usually you don't run this command directly, but it will be implicitly run by `gulp watch-build` and any build-related cordova tasks (as explained above).\n```sh\ngulp build\n```\nNote that the build will not complete if you have any **ESLint or jsonlint errors** in your code! Sometimes it's necessary to let the build run anyway. Use the `--force-build` option to do so. The `--minify` option will minify javascript, css, html and images. These options will also work for all the build-related cordova tasks!\n\n#### gulp environment\nInjects environment (dev, prod and any other you'd like) variables into your `Config` constants.\n\n##### How does it work?\nYour `main` module per default contains the two files `env-dev.json` and `env-prod.json` located under `app/main/constants/`. Any key value pair you define in those files will be copied into the `Config.ENV` constant located in `app/main/constants/config-const.js`, depending on which environment you chosse. So when you're working on dev, all key value pairs from the `main` module's `env-dev.json` will be copied to your `config-const.js`. Same goes for the prod environment respectively. Then simply inject the `Config` constant in any service or controller where you need to use it.\n\n##### Choosing an environment\nWhen you run `gulp watch` or any other task that runs `gulp build` without specifying an environment it will default to the dev environment:\n```shell\ngulp watch                # defaults to --env=dev\ngulp build                # so does this\ngulp --cordova 'run ios'  # and any other command that uses gulp build\n```\nIn order to choose an environment explicitly add the `--env` flag, like this:\n```shell\ngulp watch --env=prod\ngulp build --env=prod\ngulp --cordova 'run ios' --env=prod\n```\nWhile you're running `gulp watch` you can even **temporarily** switch the environment you're currently working on without having to restart your watch task. Simply type:\n```shell\ngulp environment --env=\u003cenv\u003e\n```\nGulp will livereload with your new environment! It's **important** to note that as soon as you are making more changes and a livereload is triggered, your environment switches back to the one that was supplied when `gulp watch` was started. If you want to **permanently** switch your environment you should do so by restarting your `gulp watch` tasks with the desired environment.\n\n##### Creating a new environment\nIf you find yourself faced needing more than a dev and a prod environment simply create a new file: `app/main/constants/dev-env5.json`, fill it with the desired values and then run one the following:\n```shell\ngulp watch --env=env5\ngulp build --env=env5\ngulp environment --env=env5\n```\n\n##### Environments when using several modules\nIn case your project grows large and you have several modules in your project you will probably find yourself wanting to share environments across all modules. No problem. Every module you create has it's own `Config` constant located in `app/module/constants/config-const.js`. But only your `main` module contains the environment files. The gulp tasks will automatically copy the environments to all of your modules' `Config.ENV` constants.\n\n\n#### gulp build-vars\nInject variables into your angular app -namely your `Config` constants which are defined in `app/*/constants/config-const.js`- during a build.\n\nAdding the `--buildVars` flag to `gulp build` or any gulp task that runs `gulp build` implicitly, for instance:\n```sh\ngulp watch --buildVars='key:value,keys2:value2'\n```\nwill result in `Config` constants that look like this:\n```js\n'use strict';\nangular.module('main')\n.constant('Config', {\n\n  ENV: {\n    /*inject-env*/\n    // ..\n    /*endinject*/\n  },\n\n  BUILD: {\n    /*inject-build*/\n    'key': 'value',\n    'keys2': 'value2'\n    /*endinject*/\n}\n\n});\n```\n\n#### gulp defaults\nDefine default flags for each gulp task.\n\nYou may have noticed that the Generator-M-Ionic supplies an extended amount of gulp tasks and flags to modify the behaviour of these tasks. Depending on your project specifics you may find yourself always typing the same flags for the same tasks over and over again. With the `gulp defaults` task you can spare yourself some typing. Here's how it works:\n\nFor instance we use `gulp watch --no-open` a lot.\n\n##### setting a default\nRunning the following command will create a new `gulp/.gulp_settings.json` file and save your default flags in it. **Note**: the `.gulp_settings.json` file will be ignored by git, so these settings are only applied locally to your machine. If you want these settings to be part of the repository and share it with your team, simply remove the according line from the `.gitignore` and add `.gulp_setting.json` to your commit.\n\n```sh\ngulp defaults --set='watch --no-open'\n```\n\nWhat if you still want use a different set of flags from time to time? No worries, we though of that too!\nYou can add any amount of **additional command line flags**, they will be merged with your defaults. In the next example `gulp watch` will run with both the `--env-prod` from the command line *and* the `--no-open` flag from your defaults.\n\n```sh\ngulp watch --env=prod ## the --no-open flag will be merged\n```\n\nYou can also **overwrite** your task's defaults by explicitly setting the flag to a different value. The value that is explicitly set, will always win:\n\n```sh\ngulp watch --open # will run with --open despite defaults\n```\n\n##### clearing a default\nIf on of the defaults is no longer required, running the following command will get rid of it:\n\n```sh\ngulp defaults --clear=watch\n```\n\n##### printing all defaults\nBy running `gulp defaults` without a 'set' or 'clear' flag, a comprehensive list of all the defaults that are defined in the `.gulp_settings.json` is shown.\n\n```sh\ngulp defaults\n```\n\n## Running on Windows\nThe generator should work just like on unix/mac except there's one difference, when running `gulp --cordova` tasks. They need doublequotes. So write this:\n```sh\ngulp --cordova \"run android\" # will work on windows\n```\ninstead of this:\n```sh\ngulp --cordova 'run android' # won't work on windows\n```\n\n## Sub-generators\n\n#### yo m-ionic:...\nA handy and fast way to create different angular components, handling all the boilerplate for you.\nThe `\u003cmoduleName\u003e` is optional and defaults to the main module when left blank\n```sh\nyo m-ionic:constant \u003cconstantName\u003e \u003cmoduleName\u003e\nyo m-ionic:controller \u003ccontrollerName\u003e \u003cmoduleName\u003e\nyo m-ionic:directive \u003cdirectiveName\u003e \u003cmoduleName\u003e\nyo m-ionic:filter \u003cfilterName\u003e \u003cmoduleName\u003e\nyo m-ionic:pair \u003cpairName\u003e \u003cmoduleName\u003e # creates controller \u0026 template\nyo m-ionic:template \u003ctemplateName\u003e \u003cmoduleName\u003e\nyo m-ionic:service \u003cserviceName\u003e \u003cmoduleName\u003e\n```\nIf you have `gulp watch` running, gulp will automatically inject your new files into your application and they will be available right away.\n\n#### yo m-ionic:module - creates a new module\n**Important**: While we are particularly proud of this feature, please note that using modules is only useful in large projects. We recommend that you only use them, if you know why you want to use them in your project. In our experience for most projects using one module is just fine.\n\n1. `yo m-ionic:module \u003cmoduleName\u003e` - create a new module\n2. choose your template: `sidemenu`, `tabs` or `blank`\n2. add your module to the `app/app.js`:\n\n  ```js\n  'use strict';\n  angular.module('myProject', [\n    // your modules\n    'main',\n    '\u003cnewModuleName\u003e'\n  ]);\n  ```\n3. restart your `gulp watch` task\n3. in your browser, depending on the template you chose, navigate to `http://localhost:9000/#`\n  - `/\u003cmodule-name-in-kebap-case\u003e` for `blank` templates\n  - `/\u003cmodule-name-in-kebap-case\u003e/list` for `sidemenu` and `tabs` templates\n4. **Done!** - see your new module in action!\n\n\n## Git integration\nThe generator provides a default set of configuration for git:\n- `.gitignore` and `.gitattributes` - http://git-scm.com/docs/gitignore\n\nLeaving them as they are generated, you will allow git to exclude all of the 3rd party code from your project. Specifically this means:\n- no bower components\n- no node modules\n- no cordova platforms and plugins\n\n### After git clone\nSince all these files are excluded from git, you need to install all of them when you start with a fresh clone of your project. In order to do so, run the following commands in that order:\n```sh\nnpm install # installs all node modules including cordova, gulp and all that\nbower install # install all bower components including angular, ionic, ng-cordova, ...\ngulp --cordova 'prepare' # install all cordova platforms and plugins from the config.xml\n```\n\n### Platforms and plugins in config.xml\nSince `cordova 5.0` all platforms and plugins you install can be added to the `config.xml`.\n\nRelease notes:\nhttps://cordova.apache.org/news/2015/04/21/tools-release.html\n\n\u003e Added the ability to manage your plugin and platform dependencies in your project’s `config.xml`. When adding plugins or platforms, use the `--save` flag to add them to `config.xml`. Ex: `cordova platform add android --save`. Existing projects can use `cordova plugin save` and `cordova platform save` commands to save all previously installed plugins and platforms into your project’s `config.xml`. Platforms and plugins will be autorestored when `cordova prepare` is run. This allows developers to easily manage and share their dependenceis among different development enviroments and with their coworkers.\n\u003e\n\nSince your projects `.gitignore` will completely ignore the `platforms/` and `plugins/` folders, it's important to make sure your `config.xml` contains all the plugins and platforms required by your project. As explained above this can either be achieved by always using the `--save` options when adding/removing platforms:\n\n```sh\ngulp --cordova 'platform add ios --save'\ngulp --cordova 'plugin remove cordova-plugin-camera --save'\n```\n\nor by typing the following commands before you commit:\n\n```sh\ngulp --cordova 'platform save'\ngulp --cordova 'plugin save'\n```\n\n## Troubleshooting\nIf you're experiencing difficulties using the generator please refer to the [Troubleshooting](https://github.com/mwaylabs/generator-m-ionic/wiki/Troubleshooting) section in our wiki or [create an issue](https://github.com/mwaylabs/generator-m-ionic/issues/new)!\n\n## Options for debugging and development\n```sh\nyo m-ionic --appName='App Name' # set appName via CLI\nyo m-ionic --skip-welcome-message # skips welcome message\nyo m-ionic --skip-sdk # skip adding cordova platforms and plugins (sdk-specific) for travis\nyo m-ionic --skip-install # for debugging purposes, no npm and bower install\nyo m-ionic --skip-prompts # for debugging purposes, run with predefined answers\nyo m-ionic --ios-only # in conjunction with --skip-prompts\nyo m-ionic --android-only # in conjunction with --skip-prompts\nyo m-ionic --no-cordova # in conjunction with --skip-prompts, no platforms/plugins\n```\n\n## Want to contribute?\nStart by reading our:\n\n1. [Mission Statement](https://github.com/mwaylabs/generator-m-ionic/wiki/Mission-Statement)\n1. [Contribution Guide](https://github.com/mwaylabs/generator-m-ionic/wiki/Contribution-Guide)\n\n\n## License\nCode licensed under MIT. Docs under Apache 2. PhoneGap is a trademark of Adobe.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwalkingriver%2Fng-cordova","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwalkingriver%2Fng-cordova","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwalkingriver%2Fng-cordova/lists"}