Dotfiles

A set of configuration files and scripts for setting up a 1000Bulbs development environment on macOS.

Requirements

Before installing these configuration files, set up your laptop using the laptop script.

Install

Install the dotfiles in your home directory.

Clone the repo

git clone https://github.com/1000bulbs/dotfiles ~/dotfiles

Install the dotfiles

env RCRC="$HOME/dotfiles/rcrc" rcup

Once you run the command above, you can run rcup without the RCRC env variable being set.

Update

To update your dotfiles:

cd ~/dotfiles
git pull origin master
rcup

Customizations

Add your own customizations

mkdir ~/dotfiles-local

Put your customizations in the ~/dotfiles-local directory with a .local extension

• ~/dotfiles-local/aliases.local/*.aliases
• ~/dotfiles-local/config/git/git_template.local/*
• ~/dotfiles-local/config/git/config.local
• ~/dotfiles-local/hooks/post-up.local
• ~/dotfiles-local/zshrc.local

These files will be automatically sourced during setup.

Oh My Zsh

Want to use Oh My Zsh? See docs/oh-my-zsh.md for instructions on how to safely install Oh My Zsh without overwriting your existing dotfiles-managed .zshrc file.

What This Sets Up

This dotfiles repo sets up and configures:

Shell Environment

• zsh configuration via zshrc
• zsh pre and post startup configs:
• color, keybindings, options, history, path, and more
• zsh completions (_rg)
• Prompt optimizations and history settings
• hushlogin to silence login messages
• Local function autocompilation support

Git Configuration

• Custom git config, gitignore, and gitmessage
• Git hooks and templates (commit-msg, pre-commit, etc.)
• Supports overrides via config.local and git_template.local

Development Tooling

• RubyGems configuration via .gemrc
• RSpec default settings via .rspec
• ASDF version manager settings via .asdfrc

Helper Scripts

Located in the bin/ directory, these include:

• git-change-branch: change branches more efficiently
• kill-port: kill processes bound to a port
• whats-on-port: check which process is using a port

Homebrew

• Integration via homebrew.zsh to ensure packages and taps are ready

Package Management

• Designed to work with rcm for dotfile management
• Modular structure allows safe extension and version control of environment config

Structure Overview

Key directories:

• zsh/ – Zsh-related configuration
• config/git/ – Git templates and config
• bin/ – Useful command-line scripts
• ssh/config – SSH client settings