{"id":19478578,"url":"https://github.com/justin-credible/ionic-typescript-mdha-starter","last_synced_at":"2025-10-08T18:04:56.237Z","repository":{"id":19835498,"uuid":"23096956","full_name":"Justin-Credible/Ionic-TypeScript-MDHA-Starter","owner":"Justin-Credible","description":":iphone: This is an boilerplate starter project I use to bootstrap mobile applications. It is built with Ionic, AngularJS, TypeScript, and runs in Cordova. It is built upon the Visual Studio Tools for Apache Cordova project provided in Visual Studio 2015.","archived":false,"fork":false,"pushed_at":"2016-03-18T14:32:28.000Z","size":7943,"stargazers_count":69,"open_issues_count":2,"forks_count":27,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-04-03T23:22:50.259Z","etag":null,"topics":["cordova","ionic","starter","typescript","visual-studio"],"latest_commit_sha":null,"homepage":"http://justin-credible.github.io/Ionic-TypeScript-Starter/","language":"C++","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/Justin-Credible.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":"2014-08-19T04:33:23.000Z","updated_at":"2024-11-28T11:18:14.000Z","dependencies_parsed_at":"2022-08-05T05:15:13.357Z","dependency_job_id":null,"html_url":"https://github.com/Justin-Credible/Ionic-TypeScript-MDHA-Starter","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justin-Credible%2FIonic-TypeScript-MDHA-Starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justin-Credible%2FIonic-TypeScript-MDHA-Starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justin-Credible%2FIonic-TypeScript-MDHA-Starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justin-Credible%2FIonic-TypeScript-MDHA-Starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Justin-Credible","download_url":"https://codeload.github.com/Justin-Credible/Ionic-TypeScript-MDHA-Starter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250844218,"owners_count":21496524,"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":["cordova","ionic","starter","typescript","visual-studio"],"created_at":"2024-11-10T19:50:35.688Z","updated_at":"2025-10-08T18:04:56.154Z","avatar_url":"https://github.com/Justin-Credible.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"Ionic-TypeScript-MDHA-Starter\n=============================\n\n\u003e Note: Unless you absolutely must use Visual Studio 2015, I strongly suggest using the IDE and platform agnostic version of this starter project: [Ionic-TypeScript-Starter](https://github.com/Justin-Credible/Ionic-TypeScript-Starter).\n\nThis is a sample project that I use as a starting point for developing new mobile applications. This starter project targets iOS, Android, and Chrome (as an extension).\n\nIt uses the [Ionic](http://ionicframework.com/) framework (version 1.x, built on [AngularJS](https://angularjs.org/) 1.x) which makes it possible to rapidly build apps that feel native.\n\nThe project is written primarily in [TypeScript](http://www.typescriptlang.org/) which decreases development time and increases maintainability (with object oriented and type-safe code, compile-time checking, and IDE tooling such as refactoring and code completion).\n\nDevelopment is done in Visual Studio 2015 using the [Visual Studio Tools for Apache Cordova](https://www.visualstudio.com/en-us/features/cordova-vs.aspx) project (previously known as **M**ulti-**D**evice **H**ybrid **A**pplication).\n\nIn-browser development and debugging is possible via the Chrome developer tools. When deployed to a physical device, the application runs in the [Cordova](http://cordova.apache.org/) application container. Both of these are provided out of the box when using VS2015.\n\n## Documentation\n\nDocumentation is available online at the [project website](http://Justin-Credible.github.io/Ionic-TypeScript-Starter).\n\n\u003e Note: Currently, this documentation is for the IDE and platform agnostic version of this starter project: [Ionic-TypeScript-Starter](https://github.com/Justin-Credible/Ionic-TypeScript-Starter). There may be several discrepancies, some of which are explained below.\n\n## Environment Setup\n\nThe following external prerequisites are required:\n\n* [Visual Studio 2015 Community](https://www.visualstudio.com/) with Update 1\n* Apache Cordova tools for Visual Studio (included with Visual Studio 2015)\n* [Node.js](https://nodejs.org/dist/v4.2.2/) 4.2.2\n\n\u003e Note: If you want to run on a emulator or physical device, you'll need your environment setup for iOS or Android development.\n\n### Configure Visual Studio\n\nThis project uses gulp to build TypeScript, SASS, etc. You'll want to make sure the **Task Runner Explorer** window is visible:\n\n* View \u003e Other Windows \u003e Task Runner Explorer\n\nNext, configure Visual Studio to use the same version of Node that is available via your path:\n\n1. Tools \u003e Options\n1. Projects and Solutions\n1. External Web Tools\n2. Add the path to your node installation to the top of the list (eg `C:\\Program Files\\nodejs`)\n\nThis can be verified by executing `node --version` at a command prompt and comparing the version to the `gulp echo-node-version` task when executed from Visual Studio's task runner explorer. More details are available [here](http://ryanhayes.net/synchronize-node-js-install-version-with-visual-studio-2015/).\n\n### Modify your path\n\nAll other dependencies are installed in the project directory via `npm`. To use them **you'll need to add `./node_modules/.bin` to your path**. Using the dependencies directly from the project directory reduces dependency hell with globally installed modules and ensures all development is done using the exact same versions of the modules.\n\nThe path should be appended via the System \u003e Environment Variables GUI and Visual Studio should be restarted for the changes to take effect.\n\n## Getting Started\n\nIn addition to installing Visual Studio, the installer will take care of downloading and setting up all the dependencies you need for developing Cordova applications (Node.js, Apache Ant, Oracle JDK 7, the Android SDK, Google Chrome and more).\n\nYou can clone the repository to your machine using:\n\n\t$ git clone https://github.com/Justin-Credible/Ionic-TypeScript-MDHA-Starter\n\nOnce you've installed VS2015, and cloned this repository you should be able to open the solution file:\n\n\tIonic-TypeScript-MDHA-Starter.sln\n \nIn the solution explorer you'll see a dependencies node with both the node and bower dependencies. If they do not automatically begin restoring, you'll have to right click them manually.\n\nAfter the dependencies are installed, you can use the various gulp tasks from the Task Runner Explorer or the command line.\n\n## Gulp Tasks\n\nThe following tasks can be used to perform code configuration, library and plugin setup, and TypeScript compilation.\n\n    $ gulp config     # Creates www/js/build-vars.js from config.xml and runtime-config.json values\n    $ gulp templates  # Compiles Angluar HTML templates from src/Views/**/*.html to www/js/templates.js\n    $ gulp sass       # Compiles SASS from src/Styles/Index.scss to www/css/bundle.css\n    $ gulp libs       # Install third Party JS libraries to www/lib as defined in bower.json\n    $ gulp tsd        # Install TypeScript definitions as defined in tsd.json\n    $ gulp ts         # Compiles TypeScript code as configured by src/tsconfig.json\n\n\u003e Note: You can also just run `gulp` without any arguments which will run all of the above targets.\n\n\u003e Note: If you have issues running `gulp` or any of the gulp tasks above, ensure that you've added `./node_modules/bin` to your path and that it is tawking precedence over npm's global location. You can verify this by using the `which gulp.cmd` from the project directory. The local `node_modules` path should be listed first. In addition, `where tsc.exe` should be run to ensure the TypeScript compiler used is from the project directory instead of Visual Studio's global version.\n\nAfter you've run the tasks, you can now use the Visual Studio play button to launch the Ripple emulator.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustin-credible%2Fionic-typescript-mdha-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjustin-credible%2Fionic-typescript-mdha-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustin-credible%2Fionic-typescript-mdha-starter/lists"}