Reframe

Light, fast and simple project scaffolder. Yeoman is powerfull but it's complicated.

Install

Download binary file for your specific platform from release page.

Or, if you are Rust and Cargo user, type:

$ cargo install reframe

Usage

$ reframe [SOURCE]

Example

$ reframe anvie/basic-rust

anvie/basic-rust is refering to my github repo: basic-rust.rf.

Build Template

To create Reframe template is super duper easy, all you needs is write file called Reframe.toml and place in root project dir, example:

[project]
name = "Hello World"
version = "1.0"

[[param]]
with_serde = { ask = "Dengan serde?", default = false }

[[param]]
serde_version = { ask = "Versi serde?", default = "1.0", if="with_serde" }

[[param]]
# without default value means required
author_name = { ask = "Author name?" }

[[param]]
author_email = { ask = "Author email?" }

Every string type param will have case variants automagically, eg: author_name will have: author_name_lowercase, author_name_snake_case, author_name_kebab_case.

After finish writing project template you can test using reframe [YOUR-WORKING-TEMPLATE-DIR], if all is ok, push to your github repo with additional postfix .rf at it repo name, eg: if your repo name is unicorn then you must push with name unicorn.rf, and finally you can use by simply typing:

$ reframe [MY-GITHUB-USERNAME]/[MY-TEMPLATE]

Example:

$ reframe agus/unicorn

For more detail please see working example at anvie/basic-rust.rf.