🌠 Stefanie's Dotfiles

Hey there! Welcome to my personal dotfiles repository! I'm Stefanie Jane, aka hyperb1iss—a creative tech enthusiast based in Seattle. These dotfiles create a powerful, consistent development environment that works seamlessly across Linux, WSL2, and Windows, with a special focus on Android development.

🌟 Core Features

Feature	Description
🐚 Shell Environment	• Unified Bash & Zsh configuration • Smart shell detection and adaptation • Enhanced history with timestamps • Modern CLI tools integration • Cross-platform consistency
📱 Android Development	• Complete AOSP build environment • Smart device management • Optimized build commands • Comprehensive udev rules • Quick navigation system
🖥️ Terminal Setup	• Custom Tmux configuration • Starship prompt with Git integration • Modern CLI replacements • Fuzzy finding and completion • Directory jumping
🪟 WSL2 Integration	• Seamless Windows/Linux operation • Path conversion utilities • File system integration • Shared Git configuration • Backup tools
🎨 Theming	• Dracula-inspired color scheme • Custom Elektra theme for Macchina • Consistent cross-tool styling • Beautiful CLI visuals • Custom icons and highlights
🛠️ Development Tools	• AstroNvim configuration • Git workflow enhancements • Docker management • Build automation • Performance optimizations

🔧 Tool Suite

📊 Core Development

Tool	Description	Features
🚀 Starship	Cross-shell prompt	• Custom prompt design • Git status integration • Context-aware display
📝 AstroNvim	Neovim configuration	• IDE-like features • Custom plugins • Intelligent completions
🖥️ Tmux	Terminal multiplexer	• Custom key bindings • Status bar configuration • Session management

🎯 Modern CLI Tools

Tool	Description	Features
🌳 FZF	Fuzzy finder	• File searching • History exploration • Command completion
📂 LSDeluxe	Modern ls	• Icon support • Color coding • Tree view
🎨 Bat	Enhanced cat	• Syntax highlighting • Git integration • Line numbering
🔍 Ripgrep	Fast searcher	• Code searching • Regular expressions • Ignore rules

🖼️ System & Customization

Tool	Description	Features
📊 Macchina	System info	• Custom Elektra theme • Performance metrics • System details
🎯 HyperShell	PowerShell env	• Linux-like experience • Custom aliases • WSL integration
🔧 DotBot	Config manager	• Automated setup • Cross-platform support • Profile management

📁 Repository Structure

dotfiles/
├── zsh/                  # Zsh configuration
├── bash/                 # Bash configuration
├── sh/                   # Shared shell utilities
│   ├── android.sh       # Android development tools
│   └── shell-utils.sh   # Common shell functions
├── hypershell/          # Windows PowerShell environment
├── nvim/                # AstroNvim configuration
├── tmux.conf            # Tmux configuration
├── starship/            # Starship prompt themes
├── elektra/             # Custom Macchina theme
└── bin/                 # Utility scripts

🔤 Installing Nerd Fonts

Nerd Fonts are required for proper icon display in the terminal. These are not automatically installed by dotbot. Follow these steps to install them:

1. Visit the Nerd Fonts website
2. Download your preferred font (I recommend JetBrainsMono Nerd Font)
3. Extract the downloaded zip file
4. Install the fonts:
   • On Windows: Right-click on each .ttf file and select "Install"
   • On macOS: Double-click each .ttf file and click "Install Font"
   • On Linux: Copy the .ttf files to ~/.local/share/fonts/ and run fc-cache -fv
5. Configure your terminal to use the installed Nerd Font

For WSL2 users, make sure to set the Nerd Font in your Windows Terminal settings as well.

🛠️ Installation

Linux/WSL2

# Clone the repository
git clone https://github.com/hyperb1iss/dotfiles.git ~/dev/dotfiles

# Install everything
cd ~/dev/dotfiles
make

Windows

# Clone the repository
git clone https://github.com/hyperb1iss/dotfiles.git $env:USERPROFILE\dev\dotfiles

# Install as administrator
cd $env:USERPROFILE\dev\dotfiles
.\install.bat

🚀 Deep Dive

🐚 Shell Environment

The shell environment provides a unified experience across Bash and Zsh:

# Modern CLI Usage Examples
ls                # Beautiful file listings with icons
ll                # Detailed list view
lt                # Tree view of directories
bat script.sh     # Syntax-highlighted file viewing
z projects        # Smart directory jumping
fzf               # Fuzzy find files or history

Key Features:

• Unified configuration across Bash and Zsh
• Enhanced history with timestamps and duplicate removal
• Intelligent tab completion with fuzzy finding
• Directory jumping with z command
• Cross-platform environment variables
• Smart aliases that work everywhere

📱 Android Development

Comprehensive tooling for AOSP and device development:

# Environment Setup
envsetup                     # Initialize build environment
lunch aosp_pixel-userdebug   # Select build target

# Building
mka bacon                    # Optimized build command
installboot                  # Smart boot image installation

# Device Management
logcat                      # Smart device selection
apush system.img            # Intelligent file pushing
aospremote                  # Configure AOSP remote
cafremote                   # Configure CAF remote

# Navigation
gokernel                    # Jump to kernel directory
govendor                    # Jump to vendor directory
goapps                      # Jump to packages/apps

Key Features:

• Automated build environment setup
• Smart device detection and management
• Performance-optimized build commands
• Comprehensive udev rules
• Quick navigation aliases

🪟 WSL2 Integration

Seamless Windows and Linux integration:

# Path Conversion
wslpath "C:\Users\Stefanie"  # Convert Windows to WSL path
wslopen ~/projects           # Open WSL path in Windows Explorer

# Navigation
cdw                         # Jump to Windows user directory

# File Operations
apush file.txt              # Smart file pushing to Android
extract archive.tar.gz      # Smart archive extraction

Key Features:

• Seamless path conversion
• File system integration
• Shared Git configuration
• WSL backup utilities
• Cross-platform clipboard support

🤖 HyperShell (PowerShell)

A Linux-like experience for Windows PowerShell:

# Linux-style Commands
ls --tree         # Directory tree with icons
grep "pattern"    # Search with ripgrep
which code        # Find executable paths

# Docker Management
dex container     # Interactive container selection
dlog container    # View container logs
dstop container   # Stop containers

Key Features:

• Linux command aliases
• WSL integration
• Docker management
• Modern CLI tools
• Custom prompt and themes

🎨 Theming System

The environment uses a carefully crafted theme based on the Dracula color palette. Each color has been specially tuned for optimal visibility and aesthetic appeal:

Color Preview	Name	Hex Code	Usage
	Background	#282a36	Terminal background, editor base
	Current Line	#44475a	Active line highlighting
	Foreground	#f8f8f2	Primary text color
	Comment	#6272a4	Comments and secondary elements
	Cyan	#5fb7c2	Symbols and constants
	Green	#3ac165	Strings and success states
	Orange	#d99a5e	Numbers and warning states
	Pink	#d664a6	Functions and special keywords
	Purple	#9d7cd6	Keywords and headings
	Red	#ff5555	Errors and deletions
	Yellow	#f1fa8c	Classes and variables

This color scheme is consistently applied across the entire environment:

• Terminal - Background, text, and highlighting colors
• Starship Prompt - Status indicators and segment colors
• Elektra Theme - System information display
• LSDeluxe - File type and permission colors
• Bat - Syntax highlighting
• Tmux - Status bar and active window indicators
• Git - Status and diff coloring

The theme provides excellent contrast and readability while maintaining a cohesive and beautiful aesthetic across all tools and interfaces.

🔄 Updating

To update the dotfiles repository:

cd ~/dev/dotfiles
git pull
make  # For Linux/WSL2
# Or
.\install.bat  # For Windows (run as administrator)

🤝 Contributing

Got ideas for improvements? Found a bug? Feel free to:

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

🚀 Other Projects

If you like these dotfiles, you might be interested in some of my other projects:

• git-iris: AI-accelerated git workflow tool
• signalrgb-homeassistant: SignalRGB integration for Home Assistant
• signalrgb-python: Python API client for SignalRGB Pro
• hyper-light-card: Custom card for controlling SignalRGB through Home Assistant
• contexter: Chrome extension and CLI for quickly copying code into LLMs
• aeonsync: An rsync backup tool for developers

📜 License

This project is open source and available under the MIT License.

---

Created by Stefanie Jane 🌠

If you find these dotfiles helpful, buy me a Monster Ultra Violet! ⚡️