Welcome to Boilermaker!

Make. Boilerplate. Sane.

So, what is it?

Boilermaker is a language-agnostic project template system for getting code projects up-and-running fast.

In other words: it means you can build and use complex templates in any language you want!

It's designed to be easy to create your own reusable templates.
It implements Sources so you can organize templates together categorically.
It's built in Rust so it's pretty fast, too.

Any official templates are guaranteed to be runnable, out of the box. This means you can get started in seconds, not hours!

Getting Started

First things first, install Boilermaker.

Next, select a language you have the runtime for and copy/paste the instructions.

          
boil install https://github.com/yeajustmars/boil-hello-world \
  --lang bash \
  --rename hello-world

boil new hello-world -l bash -Od /tmp -n hello-world-bash

cd /tmp/hello-world-bash

bash src/hello-world.sh

          
boil install https://github.com/yeajustmars/boil-hello-world \
  --lang clojure \
  --rename hello-world

boil new hello-world -l clojure -d /tmp -n hello-world-clj

cd /tmp/hello-world-clj

clojure -M -m hello-world

          
boil install https://github.com/yeajustmars/boil-hello-world \
  --lang javascript \
  --rename hello-world

boil new hello-world -l javascript -Od /tmp -n hello-world-js

cd /tmp/hello-world-js

node src/hello_world.js

          
boil install https://github.com/yeajustmars/boil-hello-world \
  --lang=python \
  --rename=hello-world

boil new hello-world -l python -Od /tmp -n hello-world-py

cd /tmp/hello-world-py

python3 src/hello_world.py

          
boil install https://github.com/yeajustmars/boil-hello-world \
  --lang rust \
  --rename hello-world

boil new hello-world -l rust -Od /tmp -n hello-world-rs

cd /tmp/hello-world-rs

cargo run

There are more langs in the official Hello World Boiler.

From here, check out the documentation to learn more about Boilermaker and how to use it!

Get Involved!

The Boilermaker Project is always looking for contributors and maintainers.

Let us know if you're interested in helping out with any of that.

You can find us on Github Discussions.

Note: Boilermaker itself is written in Rust but official templates are written in a variety of languages. If you don't know Rust, don't worry! You can still be a maintainer or contributor in other roles!