🏗️ Foundation | 📐 Layout | 🛋️ Furniture | 📦 Unpack | 🛠️ Maintain | 💡 Inspiration
This repository contains the blueprint for my digital home. These dotfiles allow me to easily move into and maintain new workstations by automatically furnishing them with the appliances and tools I use every day.
Rather than integrate and customize every new shiny tool that comes out, I prefer to keep my setup lean, practical, and rooted in principle.
A lot of what is here was inspired by others. Like many of them, I have made this repo public to serve as an open house for those on a similar journey. Feel free to take a look around and copy what you like. However, I do not recommend forking because my setup is both custom and highly volatile.
To keep things tidy, the floor plan is made up of three rooms:
- 💾 backup - Static assets and configs that require manual setup
- 🗄️ bin - Small, custom executables to be appended to
PATH - 🎨 config - Configs to be symlinked into place
My preferred fixtures at a glance:
| Operating System |  |
|---|---|
| Package Manager |  |
| Dotfile Manager |  |
| Window Manager |  |
| Status Bar |  |
| Web Browser |  |
| Password Manager |  |
| Music Player |   |
| Note Manager |  |
| Terminal Emulator & Mux |   |
| Shell |    |
| Editor |   |
| Version Control System |   |
| Typeface | Space Mono |
| Colorscheme |  |
| Programming Languages |   |
For the complete list of packages and apps that get installed, see the Brewfile.
Unpacking is the hardest part of any move. Luckily, these dotfiles come with a
builtin moving crew! The unpack.sh script explains what it
will do, prompts for confirmation before each step, and can be safely re-run to
tidy the house before having company.
In brief, unpacking...
- ✅ Verifies system compatibility
- 🔄 Checks for system updates
- ⬇️ Installs (or updates) packages and apps
- 🔗 Symlinks configs
- ⚙️ Applies system settings
Warning
Before unpacking, review the repo layout and backup any pre-existing configs.
Clone this repo and run unpack.sh:
git clone https://github.com/boldandbrad/dotfiles.git ~/Dotfiles
cd ~/Dotfiles && ./unpack.shTo make system maintanence simpler after unpacking, a handful of convenient cli tools are provided. See bin for more details.
| Command | Description |
|---|---|
mac |
Install dependencies and view system info |
slinky |
Manage dotfile symlinks |
tidyup |
Remove unwanted files and directories |
There are plenty of great dotfile repos and machine setup resources out there. In particular, I took inspiration from these gems:
- Dotfiles Community 🔗 - a great collection of dotfile resources
- dotfile repos 🔗 - my favorite github dotfile repositories
Many of the wallpaper assets found in this repo have been copied from the following sources:
- catppuccin-waves-4k.png - Credit zhichaoh/catppuccin-wallpapers
- OS Wallpapers. Credit thismoon/catppuccin-wallpapers
Copyright (c) 2021-present Bradley Wojcik. Released under the MIT License. See LICENSE for details.