es6-module-starter

Starter kit to create npm modules using ES6 and Babel with sensible defaults.

Why use this?

Want to create an npm module with ES6? Don't want to wait for full node support? Don't want to mess around with creating all those directories and setting up babel and npm scripts? Then this is for you.

How to get started

0. Install node and npm.
1. Clone this repo: git clone https://github.com/vinniegarcia/es6-module-starter.git my-module-name
2. Install dependencies: npm i
3. Start hacking like it's 2015!

Modules used/included

• babel - compiles ES6 source to ES5. The --experimental flag is also enabled so you can use ES7 features.
• tape and argg for simple, effective testing with less magic than mocha or jasmine.
• Istanbul to report test coverage.
• eslint and babel-eslint to analyze your code for stylistic issues.
• plato to analyze the complexity of your source code.
• coveralls to send your test results to coveralls.io.

These are just defaults. Feel free to swap out eslint for jshint, or tape for mocha, or whatever you use for CI instead of coveralls.

Layout

• src/ - Your ES6 source code goes here. Files have a .es6 extension for syntax highlighting in Sublime Text with babel-sublime
• src/tests/ - Your ES6 tests go here.
• src/.eslintrc - ESLint configuration
• coverage/ - Code coverage reports are output here.
• dist/ - Your generated ES5 source is output here. This directory is under gitignore.
• .gitignore - a sensible .gitignore file to prevent you from checking in generated source.
• .npmignore - preconfigured to publish only the generated source code.
• package.json - Customize this to publish your own module.
• .travis.yml - Customize this if you use Travis CI for builds.
• .coveralls.yml - Customize this if you use coveralls for code coverage.
• README.md - Delete all this and write your own.

npm scripts

These scripts are the main way to interact with your module as you develop it.

• compile - run babel to compile your ES6 source to ES5. Output goes to the dist/ directory.
• lint - run ESLint on your ES6 source and reports any style errors.
• tape - test your code.
• coverage - run Istanbul on your code to report coverage. Reports output in HTML to the coverage/istanbul directory.
• istanbul - run Istanbul, but output only lcov files for coveralls to read.
• coveralls - run coveralls, using Istanbul's lcov report as input.
• plato - run plato, a code analysis tool, on your generated source (plato doesn't support ES6 at the moment; as soon as it does I'll swap it to analyze ES6 source).
• test - run tape, Istanbul, and coveralls.
• prepublish - compiles your ES6 source to prepare for publishing to npm.

Questions?

File an issue and I'll try to answer you.