Quick Start

Install hygen:

$ npm i -g hygen

To use a generator, we supply a GENERATOR ACTION pair like so (here mailer and new are examples).

$ hygen mailer new
         |      ^----- action
         `------------ generator

Here's a quick run-down to get to your own generator:

$ hygen init self
$ hygen generator new --name awesome-generator
$ hygen awesome-generator new --name hello

To see the generator help, you could always do:

$ hygen generator help

Loaded templates: _templates
help:
hygen generator new --name [NAME] --action [ACTION]
hygen generator with-prompt --name [NAME] --action [ACTION]

Congratz! you've made a new generator called awesome-generator!

Let's walk through what we just did.

Bootstrapping Your Project

Use hygen init self to start using it in your own project. hygen comes with two pre-built generators that helps you build your own - although it was built to ease the boilerplate fatigue for React, Redux, and Node.js it can be use for any technology really.

$ cd your-project
$ hygen init self

Loaded templates: src/templates
       added: _templates/generator/with-prompt/hello.ejs.t
       added: _templates/generator/with-prompt/prompt.ejs.t
       added: _templates/generator/new/hello.ejs.t

This creates a project-local _templates folder for you at your source root with two helper generators that saves you time:

  • hygen generator new --name generatorName - builds a new generator for you
  • hygen with-prompt new --name generatorName - the same as before, only this one will be prompt driven.
Template Locality

On multi-team projects, each team can have their own templates right there in the shared repo.

Still in your project root, let's create a new generator now:

$ hygen generator new --name mygen
Loaded templates: _templates
       added: _templates/mygen/new/hello.ejs.t

And let's use it:

$ hygen mygen new

Loaded templates: _templates
       added: app/hello.js
Did You Notice?

Instead of bundling the hygen generator new command in hygen, we chose to copy it to your local templates folder.

In this way you can even tweak the way hygen generates new generators. It scales to a set up with different teams, each with its own preference.

That's it! we've done a basic walkthrough of hygen. Next up is a detailed overview of templates and generators.

What Happens If I Don't Init?

After a fresh install, hygen will use the example generators it comes with, so that you can just try out the tool. This way you can build a sample generator and see how it works from the inside, or maybe copy its contents to have a better starting point.

If you didn't hygen init self yet - let's try one:

$ hygen example-prompt new
? What's your message? welcome

Loaded templates: src/templates
       added: hygen-examples/mailers/unnamed.js
       added: hygen-examples/mailers/hello/html.ejs
       added: hygen-examples/mailers/hello/subject.ejs
       added: hygen-examples/mailers/hello/text.ejs
      inject: hygen-examples/mailers/hello/html.ejs

There are a few more ways to play with the examples:

# generate all files, with a name variable
$ hygen example-prompt new --name reporter


# generate one specific file
$ hygen example-prompt new:mailer --name reporter


# generate all resources that correspond to a regular expression
$ hygen example-prompt 'new:.*html' --name reporter

You made it to the end! nice! Now check out templates and generators.