dotfiles

Shell, git, and editor configuration for macOS and Linux.

Supports both bash and zsh with a shared config architecture that sources global, platform-specific, and host-specific settings automatically.

Setup

git clone https://github.com/mikinho/dotfiles.git && cd dotfiles
./setupenv          # symlink dotfiles to $HOME

Use ./setupenv -f to skip the confirmation prompt.

Structure

Path	Purpose
setupenv	Symlinks dotfiles to $HOME, copies SSH config, runs platform setup
mac/	macOS-specific aliases and setup (Sublime Text CLI, DNS flush, etc.)
linux/	Linux-specific config
.profile	Shared login shell config (PATH setup, JAVA_HOME)
.bashrc / .zshrc	Interactive shell config with git prompt, aliases, history
.bash_aliases	Functions and aliases shared between bash and zsh
.prompt	Bash-specific PS1 with git branch, dirty, and ahead indicators
.gitconfig	Git aliases, color settings, and workflow defaults
.vimrc	Vim defaults (4-space tabs, syntax, line numbers, key mappings)
.editorconfig	Editor-agnostic formatting rules

Project Scaffolding

Starter configs for new projects. Copy what you need:

cp -r ~/dotfiles/web/. . && cp ~/dotfiles/git/.gitignore-web .gitignore

Path	Purpose
web/	Web app configs (eslint, prettier, stylelint, htmlhint, editorconfig)
node/	npm library configs (eslint, prettier, npmignore, editorconfig)
git/	Gitignore templates (.gitignore-web, .gitignore-node, .gitignore-python)
py/	Python project configs (ruff via pyproject.toml, editorconfig)

Customization

Machine-specific config that shouldn't be tracked by git goes in:

• ~/.bashrc.local (bash)
• ~/.zshrc.local (zsh)

These are sourced automatically if they exist. You can also create ~/.<hostname> for host-specific config that applies to both shells.

Git Aliases

Some highlights from .gitconfig:

Alias	Command
git lg	Pretty graph log with author and signature status
git staged / git unstaged	Diff shortcuts for staged/unstaged changes
git undo	Soft reset last commit
git cleanup	Delete branches already merged into main
git amend	Amend with previous commit message
git compare	Show commits ahead of origin/main
git alias	List all git aliases

Note on Git Email

The .gitconfig email is intentionally invalid to force per-repo configuration:

cd your-repo
git config user.email "you@example.com"