grunt-init-pack

grunt-init template to create a project that has Node package and optionally Bower, Component, Duo, Jam and/or UMD package. Includes jshint, mocha+chai tests, jsdoc (optionally).

Usage no npm install needed!

<script type="module">
  import gruntInitPack from 'https://cdn.skypack.dev/grunt-init-pack';
</script>

README

grunt-init-pack

grunt-init template for a project that can have Node package and optionally Bower, Component, Duo, Jam and/or UMD package. Includes JSHint, Mocha+Chai tests, JSDoc (optionally).

Getting started

Installation

If you haven't already done so, install grunt-init.

npm install -g grunt-init

Once grunt-init is installed, place this template in your ~/.grunt-init/ directory. It's recommended that you use git clone to install this template into that directory as follows:

git clone https://github.com/gamtiq/grunt-init-pack.git ~/.grunt-init/pack

(Windows users should use %USERPROFILE%\.grunt-init\pack as the correct destination directory path)

To force grunt-init to use custom default values, move the defaults.json file to your ~/.grunt-init/ directory, and customize the values in that file.

Note: you can make the template available as any name you choose by simply changing the name of the folder that the template is installed into. So instead of ~/.grunt-init/pack, you may change the name to ~/.grunt-init/foo so that the template can be used with the following command: grunt-init foo. Also you can clone the template into any subdirectory outside of ~/.grunt-init/ directory. For example:

git clone https://github.com/gamtiq/grunt-init-pack.git path/to/grunt-init/templates/pack

In this case you will have to specify path to the template when running grunt-init (see below).

Usage

At the command-line, cd into an empty directory, run this command and follow the prompts.

grunt-init pack

Or

grunt-init path/to/grunt-init/templates/pack

when the template was placed in subdirectory outside of ~/.grunt-init/ directory.

Note that this template will generate files in the current directory, so be sure to change to a new directory first if you don't want to overwrite existing files.

You might want to test that it works before you begin customizing the project:

  • run npm install to install the project's dependencies; it is necessary only if you have answered no to the corresponding question
  • run grunt all to build the project and test that it works

Redefining default prompt answers

You can redefine default prompt answers using defaults.json file (see here for details). Below supported prompt names are listed:

  • name - project name
  • description - project description
  • keywords - project keywords
  • version - initial version
  • repository - project repository
  • homepage - URL of project home page
  • bugs - URL of project issues tracker
  • license - project licenses (SPDX license ID or expression)
  • author_name - author name
  • author_email - author email
  • author_url - URL of author's site
  • node_version - minimal Node.js version
  • main - main file
  • cli - whether project should have command-line interface
  • npm_test - NPM test command
  • esnext - whether project should be prepared for using of ECMAScript 2015 features
  • bower - whether project should have Bower package
  • component - whether project should have Component or Duo package
  • jam - whether project should have Jam package
  • umd - whether project should have AMD package or standalone script file
  • jsdoc - whether project should use JSDoc
  • travis - whether support for Travis CI should be added
  • travis_badge - whether Travis CI build status badge should be included into README.md
  • npm_badge - whether NPM version badge should be included into README.md
  • grunt_badge - whether Grunt badge should be included into README.md
  • history_md - to include or not History.md in the project files
  • include_config - to include or not package.json/bower.json/component.json in Gruntfile configuration
  • matchdep - to use or not matchdep module to simplify loading of plugins in Gruntfile
  • release_task - to include or not release tasks into Gruntfile
  • npm_install - to run or not npm install command automatically

Related projects

License

MIT