Awesome

🚧 Discontinued. Please use Github templates.

zel

zel is a small, and simple command-line tool that helps kickstart new projects.

Benefits

Simple JSON file to specify files via a .zel file
No complex generator/plugin API
No need to publish your boilerplate on npm (there's too many!)

Install

$ npm i -g zel

Usage

Create a .zel file in your boilerplate repository on GitHub and specify the files to expose to zel.

Repository: `vutran/editorconfig`

{
    "files": [".editorconfig"]
}

Running `zel`

To quickly clone these files, simply run zel <username>/<repository>.

$ zel vutran/editorconfig

The above command will download .editorconfig from the vutran/editorconfig repository into the current working directory.

That's it!

Dependencies

Sometimes, your boilerplate may depend on other boilerplates. You can depend on other repositories by adding it to the dependencies list in your .zel file.

Repository: `vutran/new`

{
    "dependencies": [
        "vutran/editorconfig",
        "vutran/gitignore"
    ]
}

And to bootstrap your new project:

$ zel vutran/new

Commands

Scaffold a project

$ zel vutran/new

Scaffolding a private GitHub repository

$ zel vutran/new --token abc123

Specifying a target directory for your new project

$ zel vutran/new --target ~/Project/MyNewProject

Want to scaffold your user home directory?

$ zel vutran/home --home

For more information

$ zel -h

Contributing

Clone the repository: git clone git@github.com:vutran/zel.git
Install dependencies: npm install or yarn
Install flow-typed typings: npm run flow-typed
Start Fly dev task: npm run dev
Make edits, commit
Submit a PR.