es6-jspm-gulp-boilerplate v0.4.2
ES6 + JSPM + Gulp Boilerplate
A boilerplate for developing ES6+ apps using JSPM & Gulp.
JSPM
JSPM is an all-in-one command line tool for package management, module loading and transpilation. Read more about it here and here.
Boilerplate Features
- Uses JSPM instead of Bower to manage packages
- Transpiles ES6+ automagically using Babel via JSPM
- Uses SystemJS to load modules via JSPM
- SASS compilation using LibSass and Autoprefixer
- Local dev server with LiveReload using Gulp Connect
- Testing using Karma with Mocha + Chai (bonus: write your tests in ES6)
- Linting with ESLint and SCSS-Lint
- Generates documentation automatically using ESDoc and SassDoc
- Unlicensed
Usage
- Clone this repo from
https://github.com/alexweber/es6-jspm-gulp-boilerplate.gitor install via npm:npm install es6-jspm-gulp-boilerplate - Run
npm installin the root directory (will automatically runjspm install) - Run
gulpornpm startto start the local dev server (you may need to install Gulp locally usingnpm install -g gulp) - Write an awesome app! ☺
Testing
Run karma start or npm test to run tests once.
Run npm run test:watch to run tests continuously.
Generating documentation
Run npm run docs to generate documentation for your JavaScript and SASS automatically in the docs folder.
Building
Run gulp build or npm run build to build the app for distribution in the dist folder.
Updating
In the event of issues running npm install after updating to the latest version of the boilerplate, I recommend you rm -rf node_modules, re-run npm install and go grab some coffee while it runs :)
Contributing
If you like this/find it useful/find a bug please open an issue and, better yet, submit a Pull Request! ☺ Any and all help appreciated, thanks!
No rights reserved. Made with ♥ by Alex Weber