Centaur Dotfiles

Full and clean configurations for development environment on GNU Linux and macOS.

🏗️ Project Structure

dotfiles/
├── config/              # Configuration files
│   ├── .gemrc           # Ruby gem configuration
│   ├── .gitconfig_*     # Platform-specific git configs
│   ├── .gitconfig_global # Global git configuration
│   ├── .gitignore_global # Global gitignore patterns
│   ├── .markdownlintrc  # Markdown linting rules
│   ├── .npmrc           # Node.js package manager config
│   ├── .pip.conf        # Python package manager config
│   ├── .tmux.conf.local # Tmux configuration
│   ├── .vimrc           # Vim configuration
│   ├── cargo.toml       # Rust package manager config
│   ├── ghostty.config   # Ghostty terminal config
│   └── starship.toml    # Starship prompt config
├── scripts/             # Installation and utility scripts
│   ├── install.sh       # Main installation script
│   ├── common.sh        # Shared functions and variables
│   ├── packages.sh      # Package installation module
│   ├── dotfiles.sh      # Dotfiles setup module
│   ├── install_arch.sh  # Arch Linux package installer
│   ├── install_debian.sh # Debian/Ubuntu package installer
│   ├── install_emacs.sh # Emacs installation script
│   ├── install_font.sh  # Font installation script
│   ├── install_go.sh    # Go language installer
│   ├── install_scoop.ps1 # Windows Scoop installer
│   └── Microsoft.PowerShell_profile.ps1 # PowerShell profile
├── shell/               # Shell configuration files
│   ├── .zshrc           # Zsh configuration
│   ├── .zshenv          # Zsh environment variables
│   ├── .zshrc.local     # Local zsh customizations
│   ├── config.fish      # Fish shell configuration
│   └── fish_plugins     # Fish plugin list
├── LICENSE              # Project license
├── logo.png             # Project logo
├── Brewfile             # Homebrew package list (macOS)
├── Dockerfile           # Docker configuration
├── Makefile             # Common tasks automation
├── README.md            # This file
├── _config.yml          # GitHub Pages config
├── .gitignore           # Git ignore patterns
└── logo.png             # Project logo

🚀 Quick Start

Linux & macOS

git clone https://github.com/seagle0128/dotfiles.git ~/.dotfiles
cd ~/.dotfiles
make install

To get help

> make help

Centaur Dotfiles Management

Available commands:
  install    Install all dotfiles and packages
  update     Update all configurations and packages
  clean      Clean backup files and old configurations
  sync       Synchronize dotfiles with remote repository
  test       Test configuration files
  lint       Lint configuration files
  dev-setup  Setup development environment
  backup     Backup current configurations
  restore    Restore from backup
  help       Show this help message

Windows (PowerShell)

git clone https://github.com/seagle0128/dotfiles.git ~/.dotfiles
cd ~/.dotfiles
./scripts/install_scoop.ps1

🐳 Docker

cd ~/.dotfiles
docker build -t centaur/ubuntu .
docker run -it centaur/ubuntu zsh

⌨️ Shortcuts

Alt-c: cd into the selected directory
Ctrl-r: Paste the selected command from history into the command line
Ctrl-t: Paste the selected file path(s) into the command line
TAB: To completions

🎨 Customization

ZSH Environment

Add your zsh environments in ~/.zshenv. This is recommended by ZSH officially:

export PATH=/usr/local/sbin:$PATH
export PATH=$HOME/.rbenv/shims:$PATH
export PYTHONPATH=/usr/local/lib/python2.7/site-packages

ZSH Local Config

Set your personal zsh configurations in ~/.zshrc.local:

# Oh-my-zsh plugin
zinit snippet OMZP::golang
zinit snippet OMZP::python
zinit snippet OMZP::ruby

# Github plugin
zinit light ptavares/zsh-direnv

Git Local Config

Set your git configurations in ~/.gitconfig.local:

[commit]
    # Sign commits using GPG
    gpgsign = true

[user]
    name = John Doe
    email = john.doe@example.com
    signingkey = XXXXXXXX

🛠️ Management

Using Makefile

make install      # Install dotfiles
make update       # Update all configurations
make clean        # Clean backup files
make help         # Show available commands

Manual Commands

# Update dotfiles
cd ~/.dotfiles && git pull --rebase --stat origin master

# Update Zinit plugins
zinit self-update && zinit update -a -p

# Update Homebrew packages (macOS)
brew bundle --global && brew upgrade && brew cleanup

# Update system packages (Linux)
sudo apt update && sudo apt upgrade  # Debian/Ubuntu
sudo pacman -Syu                     # Arch Linux