Simplify the process of moving into a new workstation by automatically furnishing it with your favorite app(liance)s and setting up power(ful) tools to maintain it.
Warning
My dotfiles are open source to serve as a blueprint and inspiration for others. Please feel free to explore the contents and copy what you like, but I do not recommend forking because my setup is both custom and highly volatile.
✨ TL;DR | 🛋️ Contents | 📦 Unpack | 🛠️ Maintain | 💡 Inspiration
The floor plan at a glance:
| Operating System |  |
|---|---|
| Package Manager |  |
| Launcher |   |
| Window Tiling Manager |  |
| Web Browser |  |
| Password Manager |  |
| Env, Alias, PATH & Dotfile Manager |  |
| Terminal Emulator & Mux |   |
| Shell |   |
| Editor |   |
| Version Control System |   |
| Typeface | Space Mono |
| Colorscheme |  |
| Programming Langauges |      |
The main contents of this repo are organized into the following directories:
- 💾 backup - Backups of configs that require manual setup
- 🗄️ bin - Custom executables to be appended to
PATH - 🎨 config - Package and app configs to be symlinked into place
- 🛠️ util - System specific assets and configs to be setup
The main installation script is unpack.sh. It explains what it
will do, prompts the user before each step, and is idempotent.
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 contents 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 |
dots |
Manage dotfile symlinks |
tidyup |
Clean system caches and app data |
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
- dotfyle 🔗 - discover neovim plugins and configurations, including mine
- dotfile repos 🔗 - my favorite github dotfile repositories
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.