boiler

README

Boiler

Code Once. Reuse Forever.

Store reusable code snippets and project templates locally. Automatic versioning, template variables, zero config.

Documentation • Use Cases

---

Why Boiler?

Stop installing entire packages for one function. Stop copy-pasting code between projects.

# Store once
bl store ./utils/errorHandler.js

# Reuse anywhere
bl add errorHandler

Perfect for: Utility functions, config files, project boilerplates, API templates.

---

Installation

Windows:

iwr -useb https://boiler.iamabhinav.dev/install | iex

Linux / macOS:

curl -fsSL https://boiler.iamabhinav.dev/install | bash

Verify:

bl version

---

Quick Start

# Initialize
bl init

# Store a file
bl store ./middleware/auth.js
# → Saved as auth@1.js

# Add to any project
bl add auth
# → Copied to current directory

# Fetch from remote
bl search express -r
bl add express@1 -r
# → Downloaded and initialized

# List all resources
bl ls

# Search locally
bl search auth

---

Template Variables

Create configurable snippets:

// errorHandler.js
// __var bl__LOG_LEVEL = error
// __var bl__EMAIL = admin@example.com

function handleError(err) {
  console[bl__LOG_LEVEL](err.message);
  sendEmail('bl__EMAIL', err);
}

bl add errorHandler
#   bl__LOG_LEVEL [error]: warn
#   bl__EMAIL [admin@example.com]: dev@app.com
# ✓ Created (metadata stripped, variables replaced)

---

Features

• ✅ Automatic Versioning - @1, @2, etc.
• ✅ Template Variables - bl__VAR_NAME syntax with prompts
• ✅ Remote Fetching - Pull snippets from GitHub or custom registries
• ✅ Language Agnostic - JS, Python, Go, Java, TS, Rust, C++, etc.
• ✅ Stack Templates - Store entire project folders
• ✅ Zero Config - Works immediately after install
• ✅ Cross-Platform - Windows, Linux, macOS
• ✅ Self-Updating - bl self update

---

Remote Fetching

Pull snippets from GitHub repositories or custom registries:

# Set default registry
bl conf --set-registry https://github.com/rishiyaduwanshi/boiler

# Search remote resources
bl search express -r

# Add from registry
bl add express@1 -r

# Direct GitHub repo
bl add username/repo -r
bl add username/repo:path/to/file.js -r

---

Commands

bl init              # Initialize Boiler
bl store [path]      # Store file/folder
bl add <name>        # Add snippet/stack (use -r for remote)
bl ls                # List all resources
bl search <query>    # Search by name (use -r for remote)
bl info <name>       # Show resource details
bl clean             # Remove unused versions
bl path              # Show installation paths
bl conf              # View/edit configuration
bl self update       # Update Boiler to latest
bl self uninstall    # Uninstall Boiler
bl version           # Show version
bl --help            # Full command list

Full docs: boiler.iamabhinav.dev

---

Contributing

git clone https://github.com/rishiyaduwanshi/boiler.git
cd boiler
go build -o bl main.go

See CONTRIBUTING.md for guidelines.

---

License

MIT © Abhinav Prakash

---

⭐ Star on GitHub • 📖 Docs