WINDOWS DOTFILES

Streamlined Windows Development Environment Configuration

Built with the tools and technologies:

Project Overview

Windows Dotfiles is an automated configuration system that transforms a fresh Windows development environment into a fully-equipped, personalized workspace. Designed for developers who want consistent tooling across machines, it eliminates manual setup time and ensures reproducible development environments with a single command.

Key Features

• One-Command Setup - Complete environment configuration with automated PowerShell script
• Developer-Focused Tooling - Pre-configured VS Code, Windows Terminal, and essential development tools
• Automated Application Management - Installs 25+ development applications via winget package manager
• Custom Shell Experience - Starship prompt with Git integration and enhanced PowerShell profile
• Consistent Configuration - Synchronized settings across VS Code, terminal, and development tools
• Easy Customization - Modular configuration files for personalized development preferences

Visual Demo

Starship Prompt Experience

Custom Starship prompt configuration showing Git status, directory information, and enhanced terminal experience.

Technology Stack

• Shell Environment: PowerShell, Windows Terminal, Starship prompt
• Editor: VS Code with 70+ curated extensions
• Development Tools: Git, Node.js, Python, Docker, Java JDK
• Package Management: Winget, npm, Chocolatey
• Configuration: JSON, TOML, PowerShell scripts

Installation & Setup

Prerequisites

• Windows 10/11 with PowerShell 5.1 or later
• Administrator privileges for installation
• Internet connection for downloading packages

Setup

⚠️ Important: The installation scripts require Administrator privileges. Make sure to run PowerShell as Administrator.

1. Open PowerShell as Administrator

   • Right-click on PowerShell and select "Run as Administrator"

2. Run Installation Command

   irm "https://raw.githubusercontent.com/razeevascx/dotfiles/main/win/install.ps1" | iex

3. Installation Process The script will automatically:

   • Download configuration files from the repository
   • Remove any existing dotfiles installation
   • Extract files to %USERPROFILE%\dotfiles
   • Run the setup script

4. Post-Installation Configuration

   # Configure Git with your credentials
   git config --global user.name "Your Name"
   git config --global user.email "[email protected]"

5. Verify Installation

   • Restart your terminal to apply new settings
   • Open VS Code to install extensions automatically
   • Check Starship prompt configuration

What Gets Configured

Development Environment

• Windows Terminal - Custom color schemes, fonts, and key bindings
• VS Code - 70+ extensions, settings, tasks, and snippets
• PowerShell Profile - Aliases, functions, and enhanced command history
• Starship Prompt - Git status, directory info, and execution time

Installed Applications

The configuration includes these essential development tools:

Development Tools:

• Git, GitHub Desktop
• Node.js (LTS), Python 3.13
• Docker Desktop
• Java JDK (21, 23), XAMPP

Editors & IDEs:

• Visual Studio Code
• IntelliJ IDEA Community
• JetBrains WebStorm
• JetBrains Toolbox

Terminal & Shell:

• Windows Terminal
• Starship prompt
• JetBrains Mono Nerd Font

Utilities:

• Postman, Notion
• Microsoft Teams, Office
• Quick Share, Warp Terminal

Troubleshooting

If you encounter issues during installation:

1. Administrator Rights - Ensure PowerShell is running as Administrator
2. Network Issues - Check internet connection for package downloads
3. Installation Conflicts - Close applications that might lock configuration files
4. Script Execution Policy - Run Set-ExecutionPolicy RemoteSigned if needed
5. Package Installation Failures - Some packages may require manual installation

For detailed error messages, check the PowerShell console output during installation.

Customization

Modify these configuration files to personalize your environment:

• win/terminal/settings.json - Windows Terminal appearance and behavior
• vscode/settings.json - VS Code editor preferences and workspace settings
• vscode/extensions.txt - VS Code extensions list (one per line)
• starship.toml - Shell prompt configuration and styling
• win/application/packages.json - Application installation list via winget

Adding VS Code Extensions

To add new extensions:

1. Open vscode/extensions.txt
2. Add extension identifier (e.g., ms-python.python)
3. Save and re-run setup script

Modifying Application List

To customize installed applications:

1. Edit win/application/packages.json
2. Add/remove package identifiers from the Packages array
3. Use winget search <app-name> to find package identifiers

---