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

📦 Package Management

macOS (Homebrew)

All packages are managed via Brewfile. To install:

brew bundle --global

Linux

• Debian/Ubuntu: Uses install_debian.sh
• Arch Linux: Uses install_arch.sh

Windows

• Scoop: Uses install_scoop.ps1
• Chocolatey: Alternative package manager

🖼️ Screenshots

Main (with Tmux)

Git Log

Centaur Emacs

🔄 Migration from Old Structure

If you're upgrading from an older version of these dotfiles:

1. Backup your current configurations
2. Run the new installer: make install
3. The installer will automatically detect and handle existing configurations

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgements

Related projects: DevStrap

☕ Donate

If you think this is helpful for you, please consider paying a cup of coffee for me. Thank you! 😄