Builder support libraries
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Travis Status Coverage Status

Builder Support Tools

Support tools for authoring builder archetypes.


To use the production and development workflows, install both this package and the development module:

$ npm install --save-dev builder-support


builder-support gen-dev

Use this tool to create an ARCHETYPE-dev module for publishing alongside ARCHETYPE with the same version numbers, details, etc.

This tools assumes an archetype structure of:

  • package.json - Dependencies needed for production tasks and scripts entry that has tasks for both production and development. Must have name, description fields.
  • dev/package.json - Dependencies for development tasks only.

Assuming those exist, then the tool:

  • Modifies dev/package.json as follows:

    • Copies the root package.json
    • Removes package.json:devDependencies
    • Replaces package.json:dependencies with dev/package.json:dependencies
    • Updates things like the name field to represent dev
  • Copies to dev/

  • Copies .gitignore to dev/.gitignore

This supports a workflow as follows:

$ vim              # Version notes
$ vim package.json            # Bump version
$ builder-support gen-dev     # Generate `dev/package.json||.gitignore`
$ npm run builder:check       # Last check!
$ git add .
$ git commit -m "Version bump"
$ git tag -a "vNUMBER" -m "Version NUMBER"
$ git push && git push --tags
$ npm publish                 # Publish main project
$ cd dev && npm publish       # Publish dev project

If you are bootstrapping a new archetype, a new file at dev/package.json will be generated for you automatically.

And you should be good to run builder-support gen-dev in the project root.