All of these commands require you to run npm install first. Add the --typecheck flag to generate type definitions (.d.ts) and do type checking, but keep in mind builds and rebuilds when watching will be significantly slower (~1min and ~1s respectively, vs ~20s and ~200ms without typechecking).
The latest nightly version can be installed via npm.
- Run
npm install --save ionic-angular@nightly - Your
package.jsonfile'sdependencieswill be updated with the nightly version. - Restart any
watchorservecommands that may be already running.
Run gulp build or gulp watch to watch for changes.
- Run
gulp e2eorgulp e2e.watchwith a folder passed to watch for changes. - Navigate to
http://localhost:8080/dist/e2e
- Run
gulp demosorgulp demos.watchwith a folder passed to watch for changes. - Navigate to
http://localhost:80808080/dist/demos
gulp docsto build the nightly versiongulp docs --doc-version=2.0.0to build a specific API version
From ionic directory:
gulp package buildor (gulp package watch, then open another terminal for step 2)cd distnpm link(may requiresudo)
From your app directory:
npm link ionic-angularionic serveorionic runorionic emulate
To remove the linked version of ionic-angular do npm rm ionic-angular, and then reinstall using npm install ionic-angular.
- Install Protractor:
npm install -g protractor@2.5.1 - Run
webdriver-manager update - Export
IONIC_SNAPSHOT_KEY(get from someone) - Run
gulp snapshot
gulp validate
Requires Ruby. Skip this step entirely if you are unable to install Ruby.
- See the Sass Guidelines for editing the Sass.
- Install the linter:
gem install scss_lint - Run
gulp lint.sassand fix any linter errors.
- Run
gulp lint.tsand fix any errors.
- Run snapshot & verify all changes are intentional, update master snapshot if so
- Run
gulp release
- Pulls latest from GitHub
- Runs
gulp validate - Builds npm package files into dist
- Updates package.json version
- Removes debug statements
- Updates changelog
- Publishes to npm
- Creates a new tag and release on Github
- Verify that the
changelogchanges are accurate and thepackage.jsonversion is correct (git status&&git diff) - Commit and push
- Sit back and have a beer 🍻 (or wine 🍷)
- Run
gulp nightly
- Pulls latest from GitHub
- Runs
gulp validate - Builds npm package files into dist
- Removes debug statements
- Publishes to npm using the
nightlytag with the date/time of publish added to the version:2.0.0-rc.0results in2.0.0-rc.0-201610131811
npm install ionic-angular@nightlywill now install the latest nightly release- Run
npm view ionic-angularto see the latest nightly release
Ionic Component demos are automatically compiled and deployed to the ionic staging site on every commit in ionic-preview-app. No action is necessary.
If you'd like to manually update the demos, follow the steps on the preview app for running locally on the site.
Ionic API demos are automatically compiled and deployed to the ionic staging site on every commit. No action is necessary.
If you'd like to manually update the demos, clone the ionic-site repo as a sibling of ionic. From ionic run gulp demos and then gulp docs, and it'll compile and copy the demos to the ionic-site repo, ready for testing.