Container Dotfiles

Container-optimized dotfiles for Ruby/Rails development in DevContainers.

🎯 Purpose

These dotfiles are designed specifically for Linux containers and avoid platform-specific configurations that can cause issues when mounting from macOS/Windows hosts.

📁 Structure

container-dotfiles/
├── shell/
│   ├── .zshrc          # ZSH configuration with Oh My Zsh & Powerlevel10k
│   ├── .p10k.zsh       # Powerlevel10k theme configuration
│   └── .aliases        # Common Ruby/Rails development aliases
├── git/
│   ├── .gitconfig      # Git configuration with useful aliases
│   └── .gitignore_global  # Global gitignore patterns
├── ruby/
│   ├── .gemrc          # Ruby gems configuration
│   └── .irbrc          # IRB/Rails console enhancements
├── install.sh          # Installation script
└── README.md           # This file

🚀 Installation

In DevContainers (Automatic)

Add to your devcontainer.json:

{
  "mounts": [
    "source=${localEnv:HOME}/workspace/container-dotfiles,target=/root/container-dotfiles,type=bind,consistency=cached,readonly"
  ],
  "postCreateCommand": "bash ~/container-dotfiles/install.sh"
}

Note: Git credentials (Nathan Wise nathan.wise@wealthbox.com) are configured automatically during installation.

Manual Installation

# Clone the repository
git clone https://github.com/yourusername/container-dotfiles.git ~/container-dotfiles

# Run the installer
cd ~/container-dotfiles
./install.sh

# Restart your shell
exec zsh

🎨 Features

Shell (ZSH)

• Oh My Zsh with curated plugins for Ruby/Rails development
• Powerlevel10k theme for a beautiful, informative prompt
• Useful aliases for common tasks (see shell/.aliases)
• History search with arrow keys
• asdf version manager integration

Git

• Sensible defaults for modern Git workflows
• Useful aliases (gst, gco, gl, etc.)
• Better diff and merge tools
• Global gitignore for editor files

Ruby/Rails

• Fast gem installs (no documentation, parallel downloads)
• Enhanced IRB/Rails console with helpful shortcuts
• YJIT enabled by default for performance

🔧 Customization

The installer creates symlinks, so you can update the dotfiles by pulling changes:

cd ~/container-dotfiles
git pull

Changes take effect immediately (or after source ~/.zshrc for shell configs).

🌟 Usage in Multiple Projects

These dotfiles can be used across all your Ruby projects:

1. Clone once in your container
2. Run install.sh
3. Enjoy consistent environment across projects

🤝 Contributing

This is a personal dotfiles repository, but feel free to fork and customize for your needs!

📜 License

MIT