GitHub - vutran/zel: :computer: zel is a small, and simple command-line tool that helps kickstart new projects.

2 min read Original article ↗

🚧 Discontinued. Please use Github templates.

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

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:

Commands

Scaffold a project

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?

For more information

Contributing

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

License

MIT © Vu Tran