A basic module template, that includes handy git hooks, a release script, es{6,2015} support via babel, and auto-changelog generation.
Here's what you get:
- auto-creates a
package.json - auto-creates and keeps your
.npmignorefile up-to-date - auto-creates a
CONTRIBUTING.md - auto-creates a
LICENSE - auto-creates a
README.mdwith a template that you can fill in - auto-creates a
.travis.ymlfor easy CI - tests are auto-setup in
tape, and it usessmokestackso you can do browser tests too. - auto-runs tests and linters before a
git push, to ensure you can never push bad code - auto-runs the Node Security Project advisory list against installed node modules before a
git pushto make sure your project is always secure - adds a release script to automate the headache of releasing a new version. It auto-generates a changelog, runs the tests, bumps the version, pushes to github, and publishes to npm.
Table of Contents generated with DocToc
npm install -g generator-iojs yo
yo iojsAs long as you haven't turned off es6 (and why would you!?), this file is created to configure Babel, the es6 compiler. By default, it includes a closure-elimination plugin. This makes the compiled code faster!
The Editor Config standard enforces very basic white space rules in files.
Ever accidentally commit .DS_Store to git? There are a bunch of defaults here that you almost certainly don't want to commit.
Linters are good! They save you from making silly mistakes. This is a fairly opinionated linter setup, but it catches you from many silly errors. The linter will be run before every commit and before every release.
What you commit to git and what you publish to npm don't need to be the same thing. Just like you wouldn't commit compiled files to git, you don't want to send unnecessary files to npm. When others npm install your module, they don't need all your tests or source files. These defaults strip out everything but what people really need when they install your module. It's kept up-to-date semi-automatically with dmn.
Local configuration for npm commands. Most of the time, when you're installing modules, you want to save them to package.json. This changes the default behavior of npm install to always be npm install --save. --save-dev overrides this and works as normal.
Tests are good. Automatically testing is even better. travis is free for open source modules and is a good choice for a CI server. This file is configured to automatically test your code against node 0.10, 0.12, and iojs latest. It puts you into the faster build environment on travis.
Without docs, no one (including you, 3 months from now) will be able to figure out how to use this thing you've built! This readme provides a decent structure for a readme. It includes a table of contents that is automatically updated when deploying a new version.
Changelogs are really important for open source projects, but they're a pain to maintain. This changelog will automatically get updated (but give you a chance to edit it) every time you run npm run release.
A file for github! This will show a banner above the new issue and new PR screens. This file has a set of general rules.
So much magic! This sets up your node module with good defaults, and installs a bunch of dev dependencies to make magic! There are many included scripts to make dev life easier. npm run release and npm run tdd are some favorites.
Just dummy content for your new node module.
Just a dummy test file.
If you specified this module as a CLI module, this file gets created for you. It should be a light-weight wrapper around index.js so that you can use the module both from the CLI and programatically.
To publish, run npm run release -- [{patch,minor,major}]
NOTE: you might need to sudo ln -s /usr/local/bin/node /usr/bin/node to ensure node is in your path for the git hooks to work
Tests are in tape. They can be run with npm test.
Tests can be run in a loop with npm run tdd
- npm > 2.0.0 So that passing args to a npm script will work.
npm i -g npm - git > 1.8.3 So that
git push --follow-tagswill work.brew install git
Artistic 2.0 © Joey Baker