{"id":21354351,"url":"https://github.com/christopheralphonse/dotfiles","last_synced_at":"2025-10-23T13:48:39.607Z","repository":{"id":210320834,"uuid":"545169452","full_name":"ChristopherAlphonse/dotfiles","owner":"ChristopherAlphonse","description":"Files for ZSH, PWSH, Bash, Git and VSCODE Settings","archived":false,"fork":false,"pushed_at":"2025-03-13T01:31:36.000Z","size":10722,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-13T02:28:12.185Z","etag":null,"topics":["powershell","pwsh-scripts","terminal","windows-powershell"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ChristopherAlphonse.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-03T22:48:27.000Z","updated_at":"2025-03-13T01:31:39.000Z","dependencies_parsed_at":"2023-12-02T01:24:43.010Z","dependency_job_id":"dee0c955-5ffc-499e-a48b-d047e10eab19","html_url":"https://github.com/ChristopherAlphonse/dotfiles","commit_stats":{"total_commits":24,"total_committers":3,"mean_commits":8.0,"dds":"0.20833333333333337","last_synced_commit":"df14defeb505c4a9eb60e251a85917206fcfd023"},"previous_names":["christopheralphonse/powershell","christopheralphonse/shell"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChristopherAlphonse%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChristopherAlphonse%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChristopherAlphonse%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChristopherAlphonse%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ChristopherAlphonse","download_url":"https://codeload.github.com/ChristopherAlphonse/dotfiles/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243828134,"owners_count":20354438,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["powershell","pwsh-scripts","terminal","windows-powershell"],"created_at":"2024-11-22T04:13:11.796Z","updated_at":"2025-10-23T13:48:39.588Z","avatar_url":"https://github.com/ChristopherAlphonse.png","language":"Shell","readme":"# Windows Development Environment Setup\r\n\r\n[![MIT License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\r\n[![PowerShell](https://img.shields.io/badge/PowerShell-7.4%2B-blue)](https://github.com/PowerShell/PowerShell)\r\n[![VS Code](https://img.shields.io/badge/VS%20Code-1.93%2B-blue)](https://code.visualstudio.com/)\r\n\r\nA comprehensive Windows development environment setup featuring tiling window management, enhanced terminal experience, and productivity-focused customizations. This dotfiles collection transforms Windows into a powerful development workstation with Linux-like efficiency.\r\n\r\n![Desktop Setup](./image/window_window.png)\r\n\r\n##  Overview\r\n\r\nThis setup provides a complete development environment that includes:\r\n\r\n- **Tiling Window Manager**: Komorebi for efficient window management\r\n- **Enhanced Terminal**: PowerShell with Oh My Posh, fuzzy search, and productivity tools\r\n- **Status Bar**: YASB for system monitoring and quick access\r\n- **Hotkey Daemon**: WHKD for global keyboard shortcuts\r\n- **System Info**: Fastfetch for beautiful system information display\r\n- **Gaming Optimizations**: Performance tweaks for competitive gaming\r\n\r\n## Quick Setup\r\n\r\n### One-Command Installation\r\n\r\n```powershell\r\nirm https://raw.githubusercontent.com/ChristopherAlphonse/dotfiles/refs/heads/master/bootstrap.ps1 | iex\r\n```\r\n\r\n### Manual Installation\r\n\r\n1. **Clone the repository**:\r\n   ```powershell\r\n   git clone https://github.com/ChristopherAlphonse/dotfiles.git\r\n   cd dotfiles\r\n   ```\r\n\r\n2. **Run the setup script**:\r\n   ```powershell\r\n   .\\setup-v1.ps1\r\n   ```\r\n\r\n3. **Install additional tools**:\r\n   ```powershell\r\n   winget install LGUG2Z.komorebi\r\n   winget install fastfetch\r\n   winget install LGUG2Z.whkd\r\n   winget install --id AmN.yasb\r\n   ```\r\n\r\n### Advanced Installation Options\r\n\r\nThe setup script supports various command-line parameters for customization:\r\n\r\n#### Minimal Installation\r\nInstall only essential tools (Git, VS Code, Windows Terminal):\r\n```powershell\r\n.\\setup-v1.ps1 -MinimalInstall\r\n```\r\n\r\n#### Silent/Unattended Installation\r\nRun without user prompts (auto-accepts defaults):\r\n```powershell\r\n.\\setup-v1.ps1 -Silent\r\n```\r\n\r\n#### Skip Specific Packages\r\nExclude packages by ID (comma-separated):\r\n```powershell\r\n.\\setup-v1.ps1 -SkipPackages \"Docker.DockerDesktop,Microsoft.AzureCLI\"\r\n```\r\n\r\n#### Skip Optional Components\r\nSkip VS Code extensions or dotfiles setup:\r\n```powershell\r\n.\\setup-v1.ps1 -SkipVSCodeExtensions\r\n.\\setup-v1.ps1 -SkipDotfiles\r\n```\r\n\r\n#### Skip Pre-flight Checks\r\nBypass system validation (not recommended):\r\n```powershell\r\n.\\setup-v1.ps1 -SkipPreFlightChecks\r\n```\r\n\r\n#### Custom Configuration File\r\nUse a custom config file for full control:\r\n```powershell\r\n# Copy and customize the example\r\nCopy-Item config-example.json config.json\r\n# Edit config.json with your preferences\r\n.\\setup-v1.ps1 -ConfigFile .\\config.json\r\n```\r\n\r\n#### Combined Parameters\r\nMix and match parameters for flexibility:\r\n```powershell\r\n# Silent minimal install without Docker\r\n.\\setup-v1.ps1 -Silent -MinimalInstall -SkipPackages \"Docker.DockerDesktop\"\r\n```\r\n\r\n##  Prerequisites\r\n\r\n- Windows 10/11 (Build 19041+)\r\n- [PowerShell Core 7.4+](https://apps.microsoft.com/detail/9MZ1SNWT0N5D)\r\n- Administrator privileges for system modifications\r\n- Internet connection for package downloads\r\n\r\n##  What Gets Installed\r\n\r\n### Core Development Tools\r\n\r\n- **Git** - Version control system\r\n- **VS Code** - Code editor with custom configuration\r\n- **Windows Terminal** - Enhanced terminal with custom settings\r\n- **Python 3.11** - Programming language\r\n- **Docker Desktop** - Containerization platform\r\n- **Node.js \u0026 NPM** - JavaScript runtime and package manager\r\n\r\n### Productivity Tools\r\n\r\n- **PowerToys** - Windows utilities for power users\r\n- **Slack** - Team communication\r\n- **Oh My Posh** - PowerShell prompt customization\r\n- **Chocolatey** - Package manager for Windows\r\n\r\n### Terminal Utilities\r\n\r\n- **Bat** - Modern cat replacement with syntax highlighting\r\n- **Ripgrep** - Fast search tool\r\n- **Fzf** - Fuzzy finder for command line\r\n- **Terminal-Icons** - File and folder icons in terminal\r\n- **PSReadLine** - Enhanced PowerShell command line editing\r\n- **z Directory Jumper** - Smart directory navigation\r\n\r\n## Terminal Configuration\r\n\r\n### PowerShell Customization\r\n\r\n\r\n\r\n\r\n\r\n_ps: use the `help`  command in the terminal for full pwsh commands_\r\n\r\n![help](./image/terminal_help.png)\r\nThe PowerShell profile provides a rich development experience with:\r\n- **Auto-updating profile** - Automatically syncs with the latest version\r\n- **Fuzzy file search** - `ff` command for finding files with preview\r\n- **System utilities** - `uptime`, `admin`, `winutil` commands\r\n- **Git shortcuts** - Enhanced git workflow with aliases\r\n- **File management** - `trash`, `mkcd`, `nf` commands\r\n\r\n![Terminal Experience](./image/TERMINAL.png)\r\n\r\n### Carapace Completion\r\n\r\nIntelligent tab completion that learns from your usage patterns:\r\n\r\n![Carapace Completion](./image/carapase.png)\r\n\r\n### Visual Settings\r\n\r\n- **Font**: MesloLGLDZ Nerd Font\r\n- **Theme**: Dark+ with custom colors\r\n- **Transparency**: 23% opacity with acrylic effect\r\n- **Padding**: 15px for comfortable reading\r\n\r\n### Command History\r\n\r\nEnhanced history with fuzzy search and preview:\r\n\r\n![Command History](./image/history.png)\r\n\r\n## Window Management (Komorebi)\r\n\r\n### Features\r\n\r\n- **Tiling Layouts**: BSP, Vertical/Horizontal Stack, Grid, Monocle\r\n- **Workspace Management**: 7 pre-configured workspaces per monitor\r\n- **Window Borders**: Customizable borders with focus indicators\r\n- **Animations**: Smooth window transitions (400ms duration, 120fps)\r\n- **Multi-Monitor Support**: Seamless workspace switching across displays\r\n\r\n### Key Bindings\r\n\r\n- `Alt + HJKL` - Focus windows\r\n- `Alt + Shift + HJKL` - Move windows\r\n- `Alt + 1-7` - Switch workspaces\r\n- `Alt + Shift + 1-7` - Move window to workspace\r\n- `Alt + T` - Toggle float\r\n- `Alt + F` - Toggle monocle\r\n- `Alt + R` - Retile workspace\r\n\r\n### Configuration\r\n\r\nThe Komorebi setup includes:\r\n- **7 workspace layouts** optimized for different tasks\r\n- **Custom borders** with focus indicators\r\n- **Smooth animations** for window transitions\r\n- **Multi-monitor support** with workspace isolation\r\n\r\n##  Gaming Optimizations\r\n\r\nThe `GamingTweaks.ps1` script applies competitive-level system optimizations:\r\n\r\n### Performance Enhancements\r\n\r\n- **Ultimate Performance Power Plan** - Maximum CPU/GPU performance\r\n- **Memory Management** - Optimized paging and caching\r\n- **Network Optimization** - Disabled Nagle's algorithm for low latency\r\n- **Input Queue Sizes** - Increased mouse/keyboard buffer sizes\r\n- **Hardware-Accelerated GPU Scheduling** - Reduced rendering latency\r\n\r\n### System Optimizations\r\n\r\n- **Disabled Services** - SysMain, WSearch, DiagTrack, RetailDemo\r\n- **Visual Effects** - Optimized for performance over aesthetics\r\n- **Startup Programs** - Removed non-essential startup items\r\n- **Fullscreen Optimizations** - Disabled for better gaming performance\r\n- **Game Bar** - Removed Xbox Game Bar for cleaner experience\r\n\r\n### DPC Latency Fixes\r\n\r\n- **NDU Service** - Disabled to reduce DPC latency\r\n- **HPET** - Disabled via BCD for better timing precision\r\n\r\n## VS Code Setup\r\n\r\n### Custom Configuration\r\n\r\n- **Activity Bar**: Moved to top for better space utilization\r\n- **Side Bar**: Positioned on the right\r\n- **Editor**: FiraCode Nerd Font with ligatures disabled\r\n- **Transparency**: Custom CSS for window transparency\r\n- **Animations**: Smooth transitions and effects\r\n\r\n![VS Code Setup](./image/vscode.png)\r\n\r\n### Must-Have Extensions\r\n\r\n- **Custom CSS and JS Loader** - For custom styling\r\n- **VSCode Animations** - Smooth interface animations\r\n- **Apc Customize UI++** - Advanced UI customization\r\n- **Azalais Dark Theme** - Custom dark theme\r\n- **GitHub Copilot** - AI code completion\r\n\r\n### Key Bindings\r\n\r\n- `Ctrl + [` / `Ctrl + ]` - Navigate between panels\r\n- `Ctrl + \\` - Split terminal\r\n- `Ctrl + D` - Add selection to next find match\r\n- `Ctrl + Up/Down` - Move cursor by lines\r\n- `Ctrl + N` - New file in explorer\r\n- `Ctrl + F` - New folder in explorer\r\n- `Ctrl + Shift + F5` - Run active file\r\n\r\n##  Status Bar (YASB)\r\n\r\nYASB provides a customizable status bar with:\r\n\r\n- **System Information** - CPU, memory, disk usage\r\n- **Network Status** - Connection speed and status\r\n- **Time and Date** - Current time with custom formatting\r\n- **Weather** - Current weather conditions\r\n- **Custom Widgets** - Extensible widget system\r\n\r\n##  Development Scripts\r\n\r\n### Setup Scripts\r\n\r\n- **`setup-v1.ps1`** - Main development environment setup\r\n- **`bootstrap.ps1`** - One-command installer\r\n- **`GamingTweaks.ps1`** - Gaming performance optimizations\r\n- **`dev/nerdFont.ps1`** - Nerd Font installation\r\n- **`dev/npm.ps1`** - Node.js and NPM setup\r\n\r\n### Git Configuration\r\n\r\nEnhanced Git workflow with:\r\n- **Custom aliases** - Short commands for common operations\r\n- **Editor integration** - VS Code as default editor\r\n- **Credential management** - Windows credential manager\r\n- **Safe directories** - Configured for development paths\r\n\r\n## Workflow Integration\r\n\r\n### Development Workflow\r\n\r\n1. **Start Komorebi**: `komorebic start --whkd --bar`\r\n2. **Open Terminal**: Enhanced PowerShell with productivity tools\r\n3. **Navigate**: Use `z` for smart directory jumping\r\n4. **Search**: Use `ff` for fuzzy file finding\r\n5. **Code**: VS Code with custom theme and extensions\r\n6. **Monitor**: YASB status bar for system information\r\n\r\n### Productivity Features\r\n\r\n- **Auto-updating profile** - Always latest PowerShell configuration\r\n- **Fuzzy search** - Find files and commands quickly\r\n- **Window management** - Efficient workspace organization\r\n- **System monitoring** - Real-time system information\r\n- **Gaming optimizations** - Performance when needed\r\n\r\n##  Latest Updates\r\n\r\n### April 2025\r\n\r\n- **Komorebi Integration** - Tiling window manager for Windows\r\n- **YASB Status Bar** - Customizable system monitoring\r\n- **WHKD Hotkeys** - Global keyboard shortcuts\r\n- **Fastfetch** - Beautiful system information display\r\n- **Enhanced Gaming Tweaks** - Competitive-level optimizations\r\n\r\n##  Gaming Mode\r\n\r\nFor competitive gaming, the setup includes:\r\n\r\n- **Performance optimizations** - Maximum system performance\r\n- **Low latency network** - Optimized for online gaming\r\n- **Input optimization** - Reduced input lag\r\n- **Visual optimizations** - Performance over aesthetics\r\n\r\n![Work Mode](./image/work_mode.png)\r\n\r\n\r\n\r\n\r\n# Signing off\r\n![yasb](./image/signout.png)\r\n\r\n## ⚠️ Important Notes\r\n\r\n- **Administrator Rights**: Required for system modifications\r\n- **Backup**: Registry backup created before gaming tweaks\r\n- **Restart Required**: Some changes require system restart\r\n- **Compatibility**: Tested on Windows 10/11\r\n- **Customization**: All configurations are modular and customizable\r\n\r\n##  Contributing\r\n\r\nContributions are welcome! Please feel free to submit a Pull Request.\r\n\r\n##  License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n\r\n---\r\n\r\n**Note**: These configurations are optimized for Windows with PowerShell Core and VS Code. While some components may work on other platforms, they are primarily designed for Windows development workflows.\r\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchristopheralphonse%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchristopheralphonse%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchristopheralphonse%2Fdotfiles/lists"}