dotfiles
a personal development setup for keeping editor, shell, and tooling workflows fast and reproducible.
keeps my everyday development environment reproducible across machines and reduces setup friction when i move between projects.
miscellaneous
systems tinkerer and workflow designer
duration
jun 2024 – present
mode
maintained
key stack
proof point
faster onboarding on new machines.
product surface
a personal development setup for keeping editor, shell, and tooling workflows fast and reproducible.
system surface
personal tooling can become fragile fast, especially when shell, editor, package managers, and project-specific habits drift apart.
role
systems tinkerer and workflow designer
challenge
personal tooling can become fragile fast, especially when shell, editor, package managers, and project-specific habits drift apart.
result
faster onboarding on new machines.
architecture
how the pieces connect
interface
lua, yml, toml
workflow
split editor, shell, and tool configuration into small focused modules.
data and rules
kept config grouped by tool so changes stay easy to reason about.
approach
how it was shaped
- split editor, shell, and tool configuration into small focused modules.
- kept setup scripts explicit so a fresh machine can be brought close to my daily environment quickly.
- treated the repository as a living manual for shortcuts, aliases, and workflow choices.
outcome
what it proves
- faster onboarding on new machines.
- less context switching between project setups.
- a clearer record of the tools i actually rely on every day.
decisions
- kept config grouped by tool so changes stay easy to reason about.
- favored readable setup steps over clever one-liners.
- used the repo as both automation and documentation.
lessons
- developer experience compounds when the small daily actions are smooth.
- a personal setup is easier to maintain when every file has a clear owner.
next steps
- add a fresh-machine bootstrap checklist.
- document the most-used aliases and editor motions.
- split machine-specific pieces from reusable defaults.
stack