{"id":22000695,"url":"https://github.com/boldandbrad/dotfiles","last_synced_at":"2025-07-05T05:05:52.077Z","repository":{"id":40583583,"uuid":"424818900","full_name":"boldandbrad/dotfiles","owner":"boldandbrad","description":"💻 Automated macOS setup and .file management","archived":false,"fork":false,"pushed_at":"2025-06-19T19:39:17.000Z","size":6019,"stargazers_count":4,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-02T13:16:26.009Z","etag":null,"topics":["aliae","brewfile","catppuccin-theme","dotfiles","git-config","lazygit","lsp","macos-setup","neovim-config","oh-my-posh","tmux-conf","wezterm-config","xdg","zshrc"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/boldandbrad.png","metadata":{"files":{"readme":".github/README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":".github/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-11-05T03:42:04.000Z","updated_at":"2025-06-19T19:39:20.000Z","dependencies_parsed_at":"2023-11-26T22:21:39.058Z","dependency_job_id":"9e323792-1fa5-4e9b-9062-ba171e3c4c5b","html_url":"https://github.com/boldandbrad/dotfiles","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/boldandbrad/dotfiles","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boldandbrad%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boldandbrad%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boldandbrad%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boldandbrad%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/boldandbrad","download_url":"https://codeload.github.com/boldandbrad/dotfiles/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boldandbrad%2Fdotfiles/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263687149,"owners_count":23496088,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aliae","brewfile","catppuccin-theme","dotfiles","git-config","lazygit","lsp","macos-setup","neovim-config","oh-my-posh","tmux-conf","wezterm-config","xdg","zshrc"],"created_at":"2024-11-29T23:10:28.313Z","updated_at":"2025-07-05T05:05:52.060Z","avatar_url":"https://github.com/boldandbrad.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🏠 boldandbrad's humble dotfiles\n\n![screenshot](./assets/desktop_2025-06-03.png)\n\n---\n\n## 🗝️ Welcome `$HOME`\n\nSimplify the process of moving into a new workstation by automatically\nfurnishing it with your favorite app(liance)s and setting up power(ful) tools to\nmaintain it.\n\n\u003e [!WARNING]\n\u003e My dotfiles are open source to serve as a blueprint and inspiration for\n\u003e others. Please feel free to explore the [contents](#contents) and copy what\n\u003e you like, but\n\u003e [I do not recommend forking](https://github.com/lissy93/dotfiles?tab=readme-ov-file#so-copy-paste-right)\n\u003e because my setup is both custom and highly\n\u003e [volatile](https://github.com/boldandbrad/dotfiles/commits/main/).\n\n---\n\n[✨ TL;DR](#tldr) | [🛋️ Contents](#contents) | [📦 Unpack](#unpack) |\n[🛠️ Maintain](#maintain) | [💡 Inspiration](#inspiration)\n\n---\n\n\u003ca id=\"tldr\"\u003e\u003c/a\u003e\n\n## ✨ TL;DR\n\nThe floor plan at a glance:\n\n| Operating System | ![macOS](https://img.shields.io/badge/macOS-_?logo=apple\u0026logoColor=white\u0026color=%23000000) | ![alpine](https://img.shields.io/badge/Alpine-_?logo=alpinelinux\u0026color=%230D597F) * |\n| ---------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------- |\n| Launcher \u0026 Window Tiler | ![leaderkey](https://img.shields.io/badge/LeaderKey-_?color=%23ceddef) ![raycast](https://img.shields.io/badge/Raycast-_?logo=raycast\u0026logoColor=%23FF6363\u0026color=black) | NA |\n| Web Browser | ![safari](https://img.shields.io/badge/Safari-_?logo=safari\u0026color=%23006CFF) ![duckduckgo](https://img.shields.io/badge/DuckDuckGo-_?logo=duckduckgo\u0026logoColor=white\u0026color=%23DE5833) | NA |\n| Package Manager | ![homebrew](https://img.shields.io/badge/Homebrew-_?logo=homebrew\u0026logoColor=black\u0026color=%23FBB040) | ![apk](https://img.shields.io/badge/apk-_?logo=alpinelinux\u0026color=%230D597F) |\n| Env, Alias, PATH \u0026 Dotfile Manager | ![aliae](https://img.shields.io/badge/🌱_aliae-_?logoColor=%23a0c59e\u0026color=grey) | ![aliae](https://img.shields.io/badge/🌱_aliae-_?logoColor=%23a0c59e\u0026color=grey) |\n| Terminal Emulator \u0026 Mux | ![wezterm](https://img.shields.io/badge/Wezterm-_?logo=wezterm\u0026logoColor=%234E49EE\u0026color=%23212C31) | NA |\n| Shell | ![zsh](https://img.shields.io/badge/Zsh-_?logo=zsh\u0026logoColor=white\u0026color=%23F15A24) ![oh-my-posh](https://img.shields.io/badge/Oh_My_Posh-2C7AE0) | |\n| Editor | ![neovim](https://img.shields.io/badge/Neovim-_?logo=neovim\u0026logoColor=white\u0026color=%2357A143) ![vscodium](https://img.shields.io/badge/VSCodium-_?logo=vscodium\u0026logoColor=white\u0026color=%232F80ED) | ![neovim](https://img.shields.io/badge/Neovim-_?logo=neovim\u0026logoColor=white\u0026color=%2357A143) |\n| Version Control System | ![git](https://img.shields.io/badge/git-_?logo=git\u0026color=%23f1f0e9) ![lazygit](https://img.shields.io/badge/Lazygit-_?color=%23303030) | ![git](https://img.shields.io/badge/git-_?logo=git\u0026color=%23f1f0e9) ![lazygit](https://img.shields.io/badge/Lazygit-_?color=%23303030) |\n| Typeface | \u003cimg src=\"./assets/maple-mono.png\" alt=\"maple-mono\" width=\"96\"/\u003e | NA |\n| Theme / Colorsheme | ![catppuccin-mocha](https://img.shields.io/badge/Catppuccin-Mocha-_?logoColor=%23cba6f7\u0026labelColor=%23b4befe\u0026color=%231e1e2e) | |\n| Programming Langauges | ![golang](https://img.shields.io/badge/Go-_?logo=go\u0026logoColor=white\u0026color=%2300ADD8) ![rust](https://img.shields.io/badge/Rust-_?logo=rust\u0026logoColor=white\u0026color=%23000000) ![deno](https://img.shields.io/badge/Deno-_?logo=deno\u0026logoColor=black\u0026color=%2370FFAF) ![python](https://img.shields.io/badge/Python-_?logo=python\u0026logoColor=white\u0026color=%233776AB) | |\n\n\\* experimental container support\n\n---\n\n\u003ca id=\"contents\"\u003e\u003c/a\u003e\n\n## 🛋️ Contents\n\nThe main contents of this repo are organized into a handful of high level\ndirectories: `bin/`, `config/`, and `util/`. Follow the links below to read the\ndocs for each.\n\n- 🗄️ [bin](../bin/README.md) - Custom executables to append to the user's `PATH`\n- 🎨 [config](../config/README.md) - Package and app configs to be symlinked\n into place\n- 🛠️ [util](../util/README.md) - System specific scripts and configs used while\n unpacking\n\n---\n\n\u003ca id=\"unpack\"\u003e\u003c/a\u003e\n\n## 📦 Unpack\n\nThe [contents](#contents) of this repo can be automatically installed with\n[`unpack.sh`](../unpack.sh). The unpack script explains what it will do, prompts\nthe user before each step, and is idempotent. This means it can be safely run\nmultiple times to keep the system in sync without compounding changes or\nbreaking.\n\nIn brief, unpacking does the following:\n\n- ✅ Verifies system compatibility\n- 🔄 Checks and prompts for system updates\n- ⬇️ Installs or updates user packages and apps\n- 🔗 Symlinks user package and app configs\n- ⚙️ Applies user system settings\n\n\u003e [!WARNING]\n\u003e Before unpacking, review the repo [contents](#contents) and backup any\n\u003e pre-existing configs.\n\n### Get it Delivered\n\nAutomatically download and run [`ship.sh`](../ship.sh), which clones this repo\nto `~/Dotfiles` (if not present) and then prompts you to run\n[`unpack.sh`](../unpack.sh).\n\n```sh\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/boldandbrad/dotfiles/main/ship.sh)\"\n```\n\n### Haul it Yourself\n\nManually clone this repo and run [`unpack.sh`](../unpack.sh).\n\n```sh\ngit clone https://github.com/boldandbrad/dotfiles.git ~/Dotfiles\ncd ~/Dotfiles \u0026\u0026 ./unpack.sh\n```\n\n### Mobile Home\n\n\u003e [!NOTE]\n\u003e Container support is a work in progress and considered experimental.\n\nA taste of home when you're on the road goes a long way. Spin up a simplified\nversion of this setup in a cozy alpine linux container (requires podman).\n\n```sh\ngit clone https://github.com/boldandbrad/dotfiles.git ~/Dotfiles\ncd ~/Dotfiles/bin\n./dots --run\n```\n\n---\n\n\u003ca id=\"maintain\"\u003e\u003c/a\u003e\n\n## 🛠️ Maintain\n\nTo make system maintanence simpler after unpacking, a handful of convenient\n[aliases](../config/aliae/aliae.yaml) are provided. Invoke these from anywhere.\n\n| Command | Description |\n| ------------- | ----------------------------------------------------------- |\n| `sys-clean` | Clean system caches and app data (❌ Coming soon) |\n| `dot-commit` | Persist current dotfiles to github (❌ Coming soon) |\n| `dot-relink` | Relink installed dotfiles |\n| `zsh-reload` | Reload shell environment ([`.zshrc`](../config/zsh/.zshrc)) |\n| `dep-check` | Check if all apps and dependencies are installed |\n| `dep-refresh` | Install/update all apps and dependencies |\n| `dep-prune` | Uninstall apps and dependencies that aren't needed |\n\n---\n\n\u003ca id=\"inspiration\"\u003e\u003c/a\u003e\n\n## 💡 Inspiration\n\nThere are tons of great dotfile and machine setup repos and resources out there.\nIn particular, I took inspiration from these gems:\n\n- [Dotfiles Community 🔗](https://dotfiles.github.io/) - a great collection of\n dotfile resources\n- [dotfyle 🔗](https://dotfyle.com/) - discover neovim plugins and\n configurations, including [mine](https://dotfyle.com/boldandbrad/)\n- [dreamsofcode-io/dotfiles](https://github.com/dreamsofcode-io/dotfiles) - nvim\n and tmux configs\n- [lissy93/dotfiles](https://github.com/lissy93/dotfiles) - install scripts and\n repo structure\n- [stefanzweifel/dotfiles](https://github.com/stefanzweifel/dotfiles)\n- [superatomic/dotfiles](https://github.com/superatomic/dotfiles)\n- [webpro/dotfiles](https://github.com/webpro/dotfiles)\n\n### Wallpaper Credits\n\nThe wallpaper assets found in this repo have been copied from the following\nsources:\n\n- [catppuccin-waves-4k.png](./wallpapers/catppuccin-waves-4k.png) - Credit\n [zhichaoh/catppuccin-wallpapers](https://github.com/zhichaoh/catppuccin-wallpapers/blob/main/waves/cat-waves.png)\n- OS Wallpapers. Credit\n [thismoon/catppuccin-wallpapers](https://github.com/thismoon/catppuccin-wallpapers/tree/main/os)\n\n---\n\n\u003ca id=\"license\"\u003e\u003c/a\u003e\n\n## ⚖️ License\n\nCopyright (c) 2021-present Bradley Wojcik. Released under the MIT License. See\n[LICENSE](../LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboldandbrad%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fboldandbrad%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboldandbrad%2Fdotfiles/lists"}