8000 GitHub - bleulabs/bleuprint: 🎯 Modern Mac development environment template with 120+ tools using Nix-Darwin. Security-first, reproducible, one-command setup.
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content
/ bleuprint Public template

🎯 Modern Mac development environment template with 120+ tools using Nix-Darwin. Security-first, reproducible, one-command setup.

License

MIT license
4 stars 0 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

bleulabs/bleuprint

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

25 Commits
.githooks
.githooks
Β 
Β 
.github
.github
Β 
Β 
assets
assets
Β 
Β 
docs
docs
Β 
Β 
modules
modules
Β 
Β 
scripts
scripts
Β 
Β 
.env.example
.env.example
Β 
Β 
.gitignore
.gitignore
Β 
Β 
.templateignore
.templateignore
Β 
Β 
Gemfile
Gemfile
Β 
Β 
LICENSE
LICENSE
Β 
Β 
README.md
README.md
Β 
Β 
_config.yml
_config.yml
Β 
Β 
flake.lock
flake.lock
Β 
Β 
flake.nix
flake.nix
Β 
Β 
index.html
index.html
Β 
Β 
install.html
install.html
Β 
Β 
install.sh
install.sh
Β 
Β 
justfile
justfile
Β 
Β 

Repository files navigation

Bleuprint Logo

Nix-Darwin Mac Setup Template

🎯 A template repository for bootstrapping a modern, reproducible Mac development environment with 120+ tools using Nix-Darwin.

Use this template Website Stars Forks

⭐ Star This Repository

If you find bleuprint helpful, please consider starring it! Your stars help others discover this template and motivate continued development.

✨ Features

  • πŸš€ One-command setup - Bootstrap a new Mac in ~15 minutes
  • πŸ”’ Security-first design - Safe for public repos, manual configuration required
  • πŸ“¦ 120+ modern CLI tools - Including Rust-based replacements for traditional Unix tools
  • πŸ”„ Fully reproducible - Same command = same environment, every time
  • ⚑ Instant rollbacks - Break something? Roll back in seconds
  • πŸŽ›οΈ Highly configurable - Modular design makes customization easy
  • πŸ›‘οΈ Security-first - Git hooks prevent sensitive data leaks, Touch ID sudo, encryption tools

πŸš€ Quick Start

πŸƒβ€β™‚οΈ Ultra-Quick Setup (For the Laziest)

# One-liner: Download and run with sensible defaults
curl -fsSL https://bleulabs.github.io/bleuprint/install.sh | bash

What this does:

  • βœ… Downloads the latest bleuprint template
  • βœ… Installs Nix (if not present)
  • βœ… Sets up all 120+ tools with sensible defaults
  • βœ… Configures modern shell aliases
  • βœ… No manual configuration required!

⚠️ Note: Uses sensible defaults (Developer, dev@example.local, hostname: macbook). For production use with your personal details, follow the template setup below.

πŸ“‹ Using This Template (Recommended)

  1. Click "Use this template" button above
  2. Clone your new repository
  3. Follow the Setup Guide

πŸ”§ TL;DR for Experienced Users

# After creating from template, clone your new repository
git clone https://github.com/yourusername/your-dotfiles.git
cd your-dotfiles

# πŸ”’ REQUIRED: Update configuration (for security)
# Option A: Environment file (recommended - keeps sensitive data out of repo)
cp .env.example .env           # Copy template
nano .env                      # Edit with your details
./scripts/load-env-config.sh   # Apply configuration

# Option B: Manual configuration
# nano modules/home/default.nix  # Set Git name/email
# nano flake.nix                 # Set hostname/username

# Optional: Interactive configuration wizard
./scripts/auto-configure.sh

# Bootstrap your Mac
./scripts/bootstrap-mac.sh

# Verify installation
./scripts/smoke-test.sh

⚠️ Security Notice: This template requires manual configuration of personal details. It will NOT automatically write sensitive information like emails or SSH keys to avoid security risks in public repositories.

πŸ“ Repository Structure

.
β”œβ”€β”€ flake.nix                    # Main configuration entry point
β”œβ”€β”€ scripts/                     # Setup and utility scripts
β”‚   β”œβ”€β”€ bootstrap-mac.sh         # One-click setup script
β”‚   β”œβ”€β”€ smoke-test.sh            # Verify installation
β”‚   β”œβ”€β”€ auto-configure.sh        # Interactive configuration wizard
β”‚   └── load-env-config.sh       # Environment-based configuration
β”œβ”€β”€ docs/                        # Documentation files
β”‚   β”œβ”€β”€ SETUP.md                 # Detailed setup guide
β”‚   β”œβ”€β”€ CONFIG_OPTIONS.md        # All configuration options
β”‚   └── CLI_CHEATSHEET.md        # Quick reference for tools
β”œβ”€β”€ assets/                      # Images and media files
β”‚   └── image.png                # Bleuprint logo
└── modules/
    β”œβ”€β”€ system/
    β”‚   β”œβ”€β”€ core.nix            # Languages, build tools, system settings
    β”‚   β”œβ”€β”€ cli-utils.nix       # 100+ CLI productivity tools
    β”‚   └── ml-stack.nix        # Optional ML/data science tools
    β”œβ”€β”€ homebrew/
    β”‚   └── apps.nix            # GUI apps and Mac-specific tools
    └── home/
        β”œβ”€β”€ default.nix         # User configuration (shell, git, etc.)
        └── aliases.nix         # Configurable modern tool aliases

πŸ“¦ What's Included

Development Core (modules/system/core.nix)

  • Languages: Go 1.24, Rust (via rustup), Python 3.13, Node.js 22 LTS
  • Build Tools: CMake, Make, Just, Ninja
  • Environment: direnv, nix-direnv
  • System Settings: Touch ID sudo, fast key repeat, Nix hardening (fsync)

CLI Tools (modules/system/cli-utils.nix)

  • Modern Replacements: eza/lsd (ls), bat (cat), fd (find), ripgrep (grep), erd (tree)
  • Productivity: fzf/sk, zoxide, tldr, atuin/mcfly, starship
  • Development: gh, lazygit/gitui, delta, httpie/xh/curlie, jq/yq
  • System Monitoring: btop/bottom, duf, dust, procs, bandwhich
  • Text Processing: sd, gron, choose, grex, hexyl
  • Security: age, sops, gpg, yubikey-manager
  • Containers: act, podman, dive
  • Performance: hyperfine, flamegraph, perf
  • Additional: helix, zellij, broot, silicon, mdbook

GUI Apps (modules/homebrew/apps.nix)

  • Essentials: Raycast, VS Code, OrbStack, Kitty
  • Productivity: Obsidian, Slack, Notion
  • Dev Tools: GitHub Desktop, Insomnia, TablePlus
  • Utilities: Stats, Rectangle, iTerm2, WezTerm
  • Security: 1Password, 1Password CLI

Optional: ML/Data Science Stack (modules/system/ml-stack.nix)

  • Deep Learning: PyTorch, TensorFlow (with Metal support)
  • Data Science: scikit-learn, pandas, numpy, matplotlib
  • Notebooks: Jupyter, IPython
  • Big Data: Apache Spark, DuckDB, Polars
  • Visualization: Plotly

User Config (modules/home/default.nix)

  • Shell: Zsh with syntax highlighting, autosuggestions
  • Git: Delta diffs, useful aliases, better defaults
  • Tmux: Vi mode, better keybindings, mouse support
  • SSH: Connection multiplexing for speed

πŸ”§ Common Commands

# Apply changes after editing
darwin-rebuild switch --flake ".#testhost"

# Rollback to previous generation
darwin-rebuild rollback

# Update all packages
nix flake update
darwin-rebuild switch --flake ".#testhost"

# Search for packages
nix search nixpkgs <package-name>

# Clean old generations
nix-collect-garbage -d

πŸ“ Customization

Enable Modern Tool Replacements

To replace traditional commands with modern alternatives, edit modules/home/default.nix:

# Change from:
programs.modernTools.enable = false;

# To:
programs.modernTools.enable = true;

This will set up aliases like:

  • ls β†’ eza --icons
  • cat β†’ bat
  • grep β†’ rg
  • find β†’ fd
  • top β†’ btop
  • df β†’ duf
  • du β†’ dust
  • And more...

Add a CLI tool

Edit modules/system/cli-utils.nix:

environment.systemPackages = with pkgs; [
  # ... existing packages ...
  your-new-tool  # https://link-to-docs.com
];

Add a GUI app

Edit modules/homebrew/apps.nix:

casks = [
  # ... existing casks ...
  "your-app-name"
];

Change shell aliases

Edit modules/home/default.nix:

shellAliases = {
  # ... existing aliases ...
  myalias = "my-command";
};

Enable ML/Data Science Stack

Edit flake.nix to add the ML module:

modules = [
  ./modules/system/core.nix
  ./modules/system/cli-utils.nix
  ./modules/system/ml-stack.nix  # Add this line
  ./modules/homebrew/apps.nix
  # ...
];

πŸ”— Quick Links

🀝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

πŸ“„ License

This template is available under the MIT License - see LICENSE for details.

πŸ™ Acknowledgments

  • Nix-Darwin for the excellent macOS Nix integration
  • Home Manager for user environment management
  • The Nix community for amazing packages and support

πŸ’‘ Pro Tips

  • Use tldr <command> for quick command examples
  • z <partial-path> to jump to directories (via zoxide)
  • Ctrl+R for fuzzy history search (via fzf)
  • lazygit for visual Git operations
  • btop for beautiful system monitoring
  • Run ./test-modern-tools.sh to see your current configuration

Made with ❀️ for the Mac development community
⭐ Star this repo β€’ πŸ› Report an issue β€’ πŸ’¬ Discussions

About

🎯 Modern Mac development environment template with 120+ tools using Nix-Darwin. Security-first, reproducible, one-command setup.

Topics

macos homebrew nix darwin configuration-management macos-setup developer-tools development-environment mac-bootstrap flake nix-darwin cli-tools rust-tools template-repository nix-flakes dotfiles-template modern-unix

Resource 74B4 s

Readme

License

MIT license

Code of conduct

Code of conduct

Security policy

Security policy
Activity
Custom properties

Stars

4 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Sponsor this project

Packages

No packages published

Contributors 2

  •  
  •  

Languages
0