Aucune description

xcad c4ec0035d3 Merge feature/1364-section-iteration-helper into release/v0.1.0 il y a 4 mois
.github 8074714bf1 fix(ci): extract changelog from version section instead of unreleased il y a 4 mois
cli 23f94e54f3 refactor(display): split display.py into separate manager modules il y a 4 mois
library de673db40b feat(core): remove Jinja2 default() filter extraction (#1410) (#1416) il y a 4 mois
scripts aa08a94356 fix: improve template version sync to process only changed files il y a 4 mois
tests 7b98d03e20 hotfix/v0.0.5 il y a 4 mois
.editorconfig 9990395193 chore(config): align code formatting with PEP 8 standards il y a 4 mois
.gitignore f9fdc26e1c chore: merge release/v0.0.7 into main il y a 4 mois
.yamllint 94f642aa04 fix: resolve yamllint issues il y a 4 mois
AGENTS.md bdfbda8b5d refactor(display): split DisplayManager into specialized managers il y a 4 mois
CHANGELOG.md 0c83d401f8 update changelog il y a 4 mois
LICENSE 7e7cbc3d4a Initial commit il y a 4 ans
MANIFEST.in 8921b8cb13 fix: configure package discovery and include library directory il y a 4 mois
README.md 0b770f150b new readme il y a 4 mois
SECURITY.md 52a4363e45 fixed typo il y a 2 ans
WARP.md 34f49752b2 added link il y a 5 mois
pyproject.toml f6a1b7719b chore: merge config updates from release/v0.0.7 il y a 4 mois
renovate.json e5466d997c fix(renovate): configure bot identity to prevent edit warnings il y a 4 mois
requirements.txt a95097699a chore(deps): update dependency rich to v14.2.0 (#1336) il y a 4 mois

README.md

Christian's Boilerplates

Welcome

Hey, there!

I'm Christian, and I'm passionate about creating educational tech content for IT Pros and Homelab nerds.

What are Boilerplates?

Boilerplates is a curated collection of production-ready templates for your homelab and infrastructure projects. Stop copying configurations from random GitHub repos or starting from scratch every time you spin up a new service!

Boilerplates CLI

The Boilerplates CLI tool gives you instant access to battle-tested templates for Docker, Terraform, Ansible, Kubernetes, and more.

Each template includes sensible defaults, best practices, and common configuration patterns—so you can focus on customizing for your environment.

Key Features:

  • 🚀 Quick Setup - Generate complete project structures in seconds
  • 🔧 Fully Customizable - Interactive prompts or non-interactive mode with variable overrides
  • 💾 Smart Defaults - Save your preferred values and reuse across projects

Note: Technologies evolve rapidly. While I actively maintain these templates, always review generated configurations before deploying to production.

Installation

Install the Boilerplates CLI using the automated installer:

# Install latest version
curl -fsSL https://raw.githubusercontent.com/christianlempa/boilerplates/main/scripts/install.sh | bash

# Install specific version
curl -fsSL https://raw.githubusercontent.com/christianlempa/boilerplates/main/scripts/install.sh | bash -s -- --version v1.2.3

The installer uses pipx to create an isolated environment for the CLI tool. Once installed, the boilerplates command will be available in your terminal.

Quick Start

# Explore 
boilerplates --help

# Update Repository Library
boilerplates repo update

# List all available templates for a docker compose
boilerplates compose list

# Show details about a specific template
boilerplates compose show nginx

# Generate a template (interactive mode)
boilerplates compose generate authentik

# Generate with custom output directory
boilerplates compose generate nginx my-nginx-server

# Non-interactive mode with variable overrides
boilerplates compose generate traefik my-proxy \
  --var service_name=traefik \
  --var traefik_enabled=true \
  --var traefik_host=proxy.example.com \
  --no-interactive

Managing Defaults

Save time by setting default values for variables you use frequently:

# Set a default value
boilerplates compose defaults set container_timezone "America/New_York"
boilerplates compose defaults set restart_policy "unless-stopped"

Template Libraries

Boilerplates uses git-based libraries to manage templates. You can add custom repositories:

# List configured libraries
boilerplates repo list

# Update all libraries
boilerplates repo update

# Add a custom library
boilerplates repo add my-templates https://github.com/user/templates \
  --directory library \
  --branch main

# Remove a library
boilerplates repo remove my-templates

Documentation

For comprehensive documentation, advanced usage, and template development guides, check out the Wiki (coming soon).

If you're looking for detailed tutorials on specific tools and technologies, visit my YouTube Channel.

Contribution

If you’d like to contribute to this project, reach out to me on social media or Discord, or create a pull request for the necessary changes.

Other Resources

  • Dotfiles - My personal configuration files on macOS
  • Cheat-Sheets - Command Reference for various tools and technologies

Support me

Creating high-quality videos and valuable resources that are accessible to everyone, free of charge, is a huge challenge. With your contribution, I can dedicate more time and effort into the creation process, which ultimately enhances the quality of the content. So, all your support, by becoming a member, truly makes a significant impact on what I do. And you’ll also get some cool benefits and perks in return, as a recognition of your support.

Remember, supporting me is entirely optional. Your choice to become a member or not won't change your access to my videos and resources. You are also welcome to reach out to me on Discord, if you have any questions or feedback.

https://www.patreon.com/christianlempa