description
A modern, cross-platform development environment for WSL2, Arch, and Debian, powered by chezmoi and mise.

My Dotfiles

A modern, cross-platform development environment for WSL2, Arch/EndeavourOS, and Debian/Ubuntu, powered by chezmoi and mise.

Features

• Enhanced Documentation — Professional static site powered by MkDocs Material.
• Cross-Distro — Works on Arch, EndeavourOS, Ubuntu, Debian, and WSL2.
• Tool Management — All CLI tools and environment variables managed declaratively via mise.toml.
• Auto-Sync — chezmoi apply automatically commits and pushes changes.
• Idempotent — Safe to re-run install at any time.
• Performance Optimized — Lazy-loading and optimized mise caching for faster shell initialization.
• Server Deployment: Guide for deploying to servers and homelabs via Ansible or bootstrap.

Quick Start

Tip

New here? Check out the Day One Guide for a narrative walkthrough. For detailed installation instructions (Mac, Windows, Servers), see Installation Guide.

Linux/macOS (one-line bootstrap):

curl -fsSL https://raw.githubusercontent.com/jerdaw/dotfiles/main/scripts/bootstrap | bash

Minimal / Server (dotfiles only):

./scripts/bootstrap --server

How It Works

graph LR
    repo[Using <b>mise</b> & <b>chezmoi</b>]

    repo -->|1. Installs Tools| mise[mise.toml]
    repo -->|2. Manages Dotfiles| chezmoi[chezmoi]

    mise -->|Provides| tools[NeoVim, Node, Go, Rust...]
    chezmoi -->|Configures| configs[~/.zshrc, ~/.gitconfig...]

    tools & configs -->|Powering| term[🚀 Your Terminal]

Loading

Key Tools

Tool	Category	Replaces	Description
mise	Manager	asdf/nvm	Polyglot tool version manager
chezmoi	Dotfiles	stow	Template-based dotfile manager
neovim	Editor	vim	Hyperextensible text editor
eza	Files	ls	Modern ls with icons
bat	Files	cat	Syntax-highlighted cat
ripgrep	Files	grep	Ultra-fast recursive grep
fzf	Files	-	Fuzzy finder for everything
zoxide	Navigation	cd	Smarter cd that learns
lazygit	Git	-	Terminal UI for git
atuin	Shell	history	Magical shell history sync

Note

See Tools Reference for the complete list of 60+ tools.

Maintenance

The dots command is your unified interface:

dots install              # Install dotfiles and tools
dots update               # Update everything (git pull + mise upgrade)
dots doctor               # Health check
dots test                 # Run test suite
dots sync                 # Sync repo (git pull + push)
dots cz apply             # Apply changes via chezmoi

Documentation

View Full Documentation Site →

Document	Description
Installation	Detailed setup guide
Day One Guide	Narrative walkthrough
Work Environments	Deploy to professional/work servers
Tools Reference	Full tool list & rationale
Customization	Personalization guide
Troubleshooting	Common issues and fixes
Contributing	How to contribute

License

MIT