awesome-dotfiles README

The project's README from github.com/webpro/awesome-dotfiles. As one markdown file: README.md.

Awesome Dotfiles Awesome

A curated list of dotfiles resources. Inspired by the awesome list thing. Note that some articles or tools may look old or old-fashioned, but this usually means they're battle-tested and mature (like dotfiles themselves). Feel free to propose new articles, projects or tools!

Articles

Introductions

Tutorials

Shell startup

Using specific tools

Find dotfiles repos

There are many great dotfiles repos out there, each containing their own inspiration and gems. One way to go through them is to search GitHub for "dotfiles".

Also see:

Example dotfiles repos

A collection of the most popular, well-maintained, and collaborative dotfiles repositories & frameworks. Some projects contain just the dotfiles. Others go further by allowing you to easily add your own custom dotfiles, and some include scripts to manage dotfiles and plugins.

Bash

Title Description Focus
Bash it Community bash framework. Autocompletion, themes, aliases, custom functions. Well-structured framework
Mathias’s dotfiles Sensible hacker defaults for macOS 🔧 .files, including ~/.macos — sensible hacker defaults for macOS
webpro's dotfiles macOS dotfiles Bash, Homebrew, Brew Cask, Git, Node.js, Hammerspoon.
rootbeersoup's dotfiles Effortless Bash, Vim and macOS configuration A curl | sh installer and a Makefile offer portable and effortless setup for either permanent or temporary configuration.

Zsh

Title Description Focus
Nick Khan's dotfiles Personal dotfiles for configuring macOS environment with Zsh and Homebrew. No fluff, only the stuff I actually use. Zsh, Git (w/ aliases), Visual Studio Code, Ghostty, shell aliases, sensible macOS defaults, custom CLI script, etc.
thoughtbot dotfiles Set of vim, zsh, git, and tmux configuration files Zsh, vim, tmux, git, homebrew. Uses rcm.
oh-my-zsh Community-driven framework for managing your zsh configuration. Oh My Zsh is an open source, community-driven framework for managing your Zsh configuration
Prezto The configuration framework for Zsh. Enriches the command line interface environment with sane defaults, aliases, functions, auto completion, and prompt themes.
Dries's dotfiles Simplified approach to dotfiles for macOS Zsh, Oh My Zsh, macOS, Homebrew, Mackup
holman does dotfiles Topic-oriented, fork-friendly dotfiles Zsh, Git, Vim, Homebrew, macOS, modular topic directories and bootstrap scripts.
Kevin's dotfiles macOS dotfiles for Python developers Zsh, Python, Neovim, VS Code, Homebrew, macOS defaults and security settings.
sobolevn's dotfiles Dotfiles for the developer happiness macOS, zsh, brew, vscode, codespaces, python, node, elixir
yutkat's dotfiles Well-maintained dotfiles that use CI to test and measure startup speeds. Zsh, Neovim, Wezterm, swaywm working on Arch/Ubuntu/Fedora Linux.
Luke's voidrice My dotfiles (deployed by LARBS) Zsh, vim/nvim, zsf
2KAbhishek's dots2k Passionately crafted, extensible dotfiles with multi platform support CLI tools at core, with extensions for different platforms (windows/mac/android), editors and window managers
Zim Modular, customizable, and blazing fast Zsh framework Zim is a Zsh configuration framework that bundles a plugin manager, useful modules, and a wide variety of themes, without compromising on speed.

Fish

Title Description Focus
oh-my-fish The Fish Shell Framework Core infrastructure to allow you to install packages to extend/modify your shell
Paul's dotfiles paul's fish, bash, git, etc config files. good stuff. Fish, macOS, Homebrew, Custom Shell functions

Ansible

Title Description Focus
.dots New and upgraded dotfiles, now with Ansible! Completely automated desktop setup, configuration and maintenance using Ansible
Mac Dev Playbook Mac setup and configuration via Ansible Full macOS dev machine setup including Homebrew, dotfiles, apps, and OS config
sloria's dotfiles sloria's dotfiles as Ansible roles Sets up a full local development environment with a single command

Tools

macOS

Miscellaneous

Archive/abandoned projects

License

CC0

To the extent possible under law, Lars Kappert has waived all copyright and related or neighboring rights to this work.

awesome-dotfiles (webpro/awesome-dotfiles)

Searching Database…

What is this?A curated list of dotfiles resources: articles, tutorials, example configuration repos, and tools for managing your shell and editor setup.
Is this something I install, or just a page I read?Just a reference index on GitHub, nothing to install. It gathers Articles, example dotfiles repos grouped by shell, a Tools section, and related lists.
Where should a beginner start?With the Introductions articles like 'Getting started with dotfiles', then pick a management approach from the list: a bare Git repository, GNU Stow symlinks, or a manager such as chezmoi.
Any caveats before diving in?The author warns that some entries may look old or old-fashioned, which he says usually means they're battle-tested and mature — like dotfiles themselves.
Can I reuse or fork the list itself?Yes — it's CC0: Lars Kappert has waived all copyright and neighboring rights, so the list is effectively public domain.
What exactly is a 'dotfile'?A hidden config file in your home directory, like .zshrc or .gitconfig, that controls how your shell and CLI tools behave. Keeping them versioned and in sync across machines is what this ecosystem is about.
How do I find more dotfiles repos beyond this list?The list suggests searching GitHub for 'dotfiles', including filename searches like path:/.gitconfig, and points to an Archlinux collection plus dotfiles.github.io, the unofficial guide to dotfiles.
Is the list still actively maintained?Yes — the repo is not archived, a GitHub Actions workflow (markdown-link-check) keeps links valid, and the author invites proposals; abandoned projects are moved to a separate Archive section rather than deleted.
Does the author follow his own advice?Yes — webpro's own macOS dotfiles (Bash, Homebrew, Brew Cask, Git, Node.js, Hammerspoon) are listed in the Bash section, next to repos like holman's and thoughtbot's.
Creator
webpro
Size
0.1 MB
Stars
10.9K
Updated
CommitOct 11
Age
12y
Commits · 90 Days