dots-quantum

Project

dots-quantum - Primary Dotfiles

Priority

P1 - High

Status

Active (Primary)

Owner

Evan

Architecture

Flat stow-managed packages

Theme

Catppuccin Mocha

WM

Hyprland

Repository

_projects/personal/dots-quantum

Flat, opinionated dotfiles configuration focused on Hyprland + Catppuccin Mocha. Replaces the complex nested structure of dotfiles-optimus with a simpler, single-platform approach.

Aspect dotfiles-optimus (Legacy) dots-quantum (Current)

Structure

Nested (base/, shell/, terminal/, editor/, wm/, apps/)

Flat (each package is top-level directory)

Installer

.optimus/install.sh with flags

Direct stow commands

Theme

Multiple options

Catppuccin Mocha (consistent)

WM Focus

Multiple options

Hyprland-centric

Complexity

High (modular, multi-platform)

Low (opinionated, single-platform)

 
cd ~/atelier/_projects/personal/dots-quantum

# Stow individual packages
stow -t ~ bash
stow -t ~ git
stow -t ~ hyprland

# Stow multiple packages
stow -t ~ bash bin git fzf ripgrep fd

# Restow (update symlinks)
stow -R -t ~ bash

Local Overrides

Configuration supports local overrides that aren’t tracked in git:

Override Purpose

~/.bashrc.local

Machine-specific bash config

~/.config/hypr/local.conf

Machine-specific Hyprland config

~/.gitconfig.local

Machine-specific git config

See Dotfiles Migration for the complete migration status from dotfiles-optimus to dots-quantum.

Symlinks to Update

After migration, update symlinks in _projects/personal/:

# Old (pointing to optimus)
bash -> dotfiles-optimus/base/bash

# New (pointing to quantum)
bash -> dots-quantum/bash

All packages use Catppuccin Mocha as the unified color scheme. This ensures visual consistency across every tool in the stack.

Palette Reference

Color Hex Usage

Base

#1e1e2e

Primary background

Mantle

#181825

Darker background (sidebars, panels)

Crust

#11111b

Darkest background (borders, dividers)

Surface 0

#313244

Inactive elements

Surface 1

#45475a

Hover states

Text

#cdd6f4

Primary text

Subtext 0

#a6adc8

Secondary text

Lavender

#b4befe

Accents, selections

Blue

#89b4fa

Links, primary actions

Sapphire

#74c7ec

Info, highlights

Green

#a6e3a1

Success, git additions

Red

#f38ba8

Errors, git deletions

Peach

#fab387

Warnings

Mauve

#cba6f7

Keywords, special

Per-Package Theme Configuration

Package Theme Source

hyprland

Border gradient: Blue → Mauve → Pink (animated cycle in hyprland.conf)

hyprlock

Catppuccin Mocha Blue/Lavender lock screen

kitty

Inline palette in kitty.conf — Aqua/Teal Elegance variant

ghostty

Catppuccin Mocha theme file

waybar

CSS with Catppuccin variables in style.css

wofi

CSS using Catppuccin Surface/Text colors

mako

Background/text colors in config

btop

catppuccin_mocha.theme file in ~/.config/btop/themes/

tmux

AETHELRED theme (Catppuccin Mocha compatible) in tmux.conf

cava

Custom shaders + Catppuccin gradient colors

lazygit

Catppuccin Mocha in config.yml

zathura

Catppuccin recolor settings in zathurarc

oh-my-posh

Custom theme JSON using Catppuccin accent colors

nwg-look

GTK: catppuccin-mocha-blue-standard+default via nwg-look

cursors

catppuccin-mocha-dark-cursors

GTK/Qt Integration

# GTK theme (installed via yay)
yay -S catppuccin-gtk-theme-mocha catppuccin-cursors-mocha
# Apply via nwg-look or gsettings
# Qt follows GTK via environment variables in hyprland.conf:
# env = QT_QPA_PLATFORMTHEME,qt5ct

Improvement Proposals

Proposals from ecosystem audit — 2026-04-04. For team review and prioritization.
Priority Proposal Rationale Effort

P1 → RESOLVED

Add bin package documentation (adoc-stem, adoc scripts)

Built custom LaTeX-to-SVG preprocessor (adoc-stem) after asciidoctor-mathematical failed on Arch/Ruby 3.4. Integrated into adoc script’s to_pdf(). Documented in bin-package.adoc partial. Resolved 2026-04-05.

M

P1

Add field-notes partial (decisions, lessons, backlog)

dots-quantum is the most comprehensive project (45 stow packages, 22+ partials) yet has zero decision documentation. Architecture choices will be forgotten.

M

P1

Document stow dependency graph

Some packages depend on others (e.g., zsh config references fzf, tmux references tpm). Undocumented dependencies break fresh deploys.

M

P2

Package changelog (what changed in each stow package)

With 45 packages evolving independently, tracking what changed and why is critical for rollback decisions.

L

P2

Migration guide for new machines

thinkpad-t16g deployment revealed gaps in the fresh-machine workflow. A dedicated guide prevents repeating mistakes.

M

P3

Automated validation script documentation

Document the stow --simulate and post-stow verification commands as a reusable runbook partial.

S

Stow Dependency Graph

The 45 stow packages have implicit dependencies that are not documented anywhere. A directed graph showing which packages reference files from other packages would:

  • Prevent broken symlinks when deploying a subset

  • Clarify the correct stow order for fresh machines

  • Identify circular dependencies that should be eliminated

Recommended format: D2 or Mermaid diagram in a partials/stow-dependency-graph.adoc partial, renderable via Kroki.

Project Metadata

Field Value

Repository

GitHub / GitLab / Gitea (internal)

License

MIT

Stow Target

~ (home directory)

Theme

Catppuccin Mocha (all packages)

Shell

zsh (primary), bash (fallback)

Terminal

Ghostty (primary), Kitty (secondary)

WM

Hyprland (Wayland)

Predecessor

dotfiles-optimus (archived)

Related