Lucas Vienna's Dotfiles

• Lucas Vienna's Dotfiles
  • What's Included
  • Quick Start
    • Prerequisites
    • Installation
    • Try It First (Docker)
  • Themes
    • Included Themes
  • Maintenance
  • Customization
    • Method 1: Configuration File (Recommended)
    • Method 2: Local Overrides
    • Method 3: Fork & Branch
  • WSL 2 Notes
  • Project Structure
  • Requirements
  • Documentation
  • License
  • Author
  • Acknowledgments

A comprehensive developer environment setup that gets you from zero to productive in minutes. These dotfiles automate the installation and configuration of modern development tools across macOS, Debian, Ubuntu, Arch (including CachyOS), and WSL 2.

What's Included

One command installs and configures:

• Shell: Zsh with Oh-My-Zsh, custom plugins, and productivity aliases
• Terminal Multiplexer: Tmux with sensible defaults and TPM plugin manager
• Editor: Neovim with LazyVim framework, LSP support, and custom configurations
• Modern CLI Tools: ripgrep, fd, fzf, btop, bottom, lazygit, delta, and more
• Navigation: ghq for repository management, zoxide for frecency-based cd
• Development: Node, Python, Go, Rust, Bun via Mise runtime manager
• Security: SSH/GPG key generation and Git commit signing
• Theming: System-wide theme switching across all applications

Platform Support: macOS, Debian, Ubuntu, Arch / CachyOS, WSL 2

Tools come from the platform's own package manager where that manager keeps up: APT plus Mise on Debian, Homebrew on macOS, and plain pacman plus the AUR on Arch — no Mise tool layer there, since the repos are already current.

Quick Start

Prerequisites

You'll need curl and Bash 4+ installed:

Debian/Ubuntu:

apt-get update && apt-get install -y curl

Arch/CachyOS:

sudo pacman -Sy --needed curl

macOS (Apple Silicon):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" \
  && eval "$(/opt/homebrew/bin/brew shellenv)" \
  && brew install bash \
  && bash

macOS (Intel):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" \
  && eval "$(/usr/local/bin/brew shellenv)" \
  && brew install bash \
  && bash

Installation

Run this one-liner to bootstrap your entire development environment:

bash <(curl -fsSL https://raw.githubusercontent.com/lucasvienna/dotfiles/main/bootstrap)

The bootstrap script is idempotent and safe to run multiple times. It will:

1. Detect your environment (macOS / Debian / Ubuntu / Arch / WSL 2)
2. Install critical packages (Homebrew + Bash on macOS, sudo + git on Linux)
3. Clone the repo to a directory of your choice
4. Hand off to ./install, which moves any existing config aside as a .bak before symlinking over it — nothing is deleted, and existing backups are never overwritten
5. Set up everything in ~5 minutes

After the bootstrap clones the repo, you can re-run the install at any time:

cd ~/dotfiles && ./install              # full install
cd ~/dotfiles && ./install --symlinks   # only re-stow symlinks
cd ~/dotfiles && ./install --help       # all flags

Skip system packages (handle them manually):

bash <(curl -fsSL https://raw.githubusercontent.com/lucasvienna/dotfiles/main/bootstrap) && \
  cd ~/dotfiles && ./install --skip-system-packages

Try It First (Docker)

Test drive without touching your system:

docker container run --rm -it -e "IN_CONTAINER=1" -v "${PWD}:/app" -w /app debian:stable-slim bash

# Inside the container:
apt-get update && apt-get install -y curl \
  && bash <(curl -fsSL https://raw.githubusercontent.com/lucasvienna/dotfiles/main/bootstrap) --local \
  && zsh -c ". ~/.config/zsh/.zprofile && . ~/.config/zsh/.zshrc; zsh -i"

Themes

Switch between included themes with a single command:

# List available themes
dot-theme-set --list

# Set a specific theme
dot-theme-set tokyonight-moon

# Random theme
dot-theme-set

Themes update automatically across Neovim, tmux, fzf, btop, bottom, Alacritty, Ghostty, and gitui.

Alacritty repaints instantly (it imports the theme and has live_config_reload on), btop and Ghostty reload on a signal, and btm needs a restart — bottom has no reload mechanism, so dot-theme-set tells you when one is running.

Included Themes

• Tokyonight Moon: High contrast, excellent for recordings
• Catppuccin Macchiato: Soft pastels on a medium-dark base
• Dracula Pro: Modern dark theme with vibrant accents — licensed, fetched on demand

Add your own themes by creating a new directory in themes/ with configs for each app.

Licensed themes. Dracula PRO is a paid theme, so its colours aren't in this repo. themes/dracula-pro/ is git-ignored and rendered on demand from the templates in _themes/dracula-pro/, which hold structure but no colours:

dot-theme-fetch              # render dracula-pro
dot-theme-fetch --list       # what can be fetched
dot-theme-set dracula-pro    # then apply it

This needs membership of the dracula-pro GitHub org and an authenticated gh. Colours come from that org's palette repo; the alacritty and ghostty themes are fetched verbatim from the org rather than templated, since the official files carry more detail. If you try to apply the theme before fetching it, dot-theme-set tells you so.

Maintenance

Once installed, manage your dotfiles with these commands:

cd "${DOTFILES_PATH}"

# Update everything (packages, configs, plugins)
./install

# Update configs only (skip packages)
./install --skip-system-packages

# Pull latest changes without installing
./install --pull

# Pull and install in one command
./install --update

# Compare your config with the example
./install --diff-config

# Preview incoming changes
./install --diff

# View available updates
./install --new-commits

Customization

Method 1: Configuration File (Recommended)

Copy install-config.example to install-config and customize:

# Add extra packages (per platform)
export BREW_PACKAGES_EXTRAS="package1 package2"
export APT_PACKAGES_EXTRAS="package1 package2"
export PACMAN_PACKAGES_EXTRAS="package1 package2"
export AUR_PACKAGES_EXTRAS="package1 package2"

# Arch only: pin an AUR helper. Empty auto-detects paru, then yay, then
# shelly, and builds paru from the AUR if none are installed.
export AUR_HELPER="shelly"

# Add programming languages
export MISE_LANGUAGES_EXTRAS["ruby"]="ruby@3.4"

# Pre-fill your git config
export YOUR_NAME="Your Name"
export YOUR_EMAIL="your@email.com"

The install-config file is git-ignored, so your customizations persist across updates.

Method 2: Local Overrides

These files are sourced but never tracked:

• .config/zsh/.zshrc.local - Shell customizations
• .config/zsh/.aliases.local - Custom aliases
• .config/git/config.local - Git configuration
• .config/alacritty/local.toml - Per-machine font, size and window title

Method 3: Fork & Branch

For major customizations:

git checkout -b my-customizations
# Make your changes
git commit -am "Personalize setup"

# Merge upstream updates
git pull origin main
git rebase main

WSL 2 Notes

The install script automatically:

• Configures /etc/wsl.conf for optimal performance
• Copies .wslconfig to your Windows user directory
• Sets up clipboard sharing via WSLg

After installation, restart WSL from PowerShell:

wsl --shutdown

Note: Systemd is intentionally disabled to avoid the 10-15 second startup delay.

Project Structure

.config/           # Application configurations
├── nvim/          # Neovim (LazyVim)
├── tmux/          # Tmux with TPM
├── zsh/           # Zsh with Oh-My-Zsh (+ .zshrc.arch on Arch)
├── git/           # Git with delta, signing
├── alacritty/     # Terminal (alacritty.toml imports base + theme + local)
├── ghostty/       # Terminal emulator
├── fzf/           # Fuzzy finder
├── bottom/        # System monitor (base.toml, merged with theme styles)
└── btop/          # System monitor

.local/bin/         # Custom scripts
├── dot-theme-set   # Theme switcher
├── dot-theme-fetch # Render licensed themes from templates
├── clip-copy       # Cross-platform clipboard
├── clip-paste      # Clipboard utilities
└── mkscript        # Script generator

_install/          # Installer data, separate from install's logic
├── env            # Shared helpers, OS + AUR helper detection
├── packages/      # Per-OS package lists: debian, darwin, arch
├── mise_languages # Language runtimes
└── symlinks       # Stow rules

themes/            # System-wide themes
_themes/           # Templates for licensed themes (structure, no colours)
install            # Main installation script
install-config     # Your customizations (git-ignored)

Requirements

• Zsh 5.0+
• Tmux 3.1+
• Neovim 0.11+
• Git 2.0+

The install script handles all dependencies automatically.

Documentation

For detailed information about the architecture, customization options, and troubleshooting, check out CLAUDE.md.

License

MIT - Feel free to use any part of this configuration.

Author

Lucas Vienna Developer & DevOps Engineer

These dotfiles power my daily development workflow across multiple machines and environments. They're battle-tested through years of professional development work.

Questions? Issues? Feel free to open an issue or submit a PR.

Acknowledgments

This repository is a fork of Nick Janetakis' dotfiles. Huge thanks to Nick for creating such a comprehensive and well-documented foundation that made this setup possible. His original work includes excellent blog posts and videos about the various configurations if you want to dive deeper into the implementation details.