!MacOS Preview !Windows Preview

Development Setup (Windows & macOS)

A complete automation system for setting up and managing your developer workstation on Windows and macOS. This repository provides everything you need to configure your development environment, manage applications, automate daily tasks, and optimize your workflow.

Recommendation

I don't want everyone to copy this entire repo and use it because it is my own opinionated setup, not something for everyone. I recommend checking this repo, taking ideas from it, and implementing them in a way that fulfills your own requirements.

Features & Capabilities

• Windows System Configuration

• macOS System Configuration

• Application Management

• Enhanced Shell Experience

• Git Workflow Tools

• Smart Slack Integration

• Automated Startup Tasks

• Code Editor Setup

Getting Started

Prerequisites

Before you begin, make sure you have:

• Windows 10/11 or macOS installed
• Git installed (to clone the repository)
• Go installed (version specified in go.mod)
• MSYS2 (Windows, optional for Bash/Fish) or Homebrew (macOS)
• Scoop (Windows package tools)

Installation Guide

Follow these steps to set up your development environment:

1. Clone the Repository

git clone https://github.com/NazmusSayad/.dotfiles.git
    cd .dotfiles

1. Initial Setup

This will set up the dotfiles directory and add tools to your PATH.

1. Build All Utilities

1. Configure Your Environment

1. Optional: Platform System Configuration

1. Optional: Additional Setup

Using the Tools

For Ubuntu WSL and the browser shell at sh.sayad.dev, see the WSL setup and workflow guide.

Once installed, you can use these commands from anywhere in your terminal:

Package Management:

• packages-sync / psy - Sync configured packages
• winget-install / wgi - Install configured Winget applications (Windows)
• winget-upgrade / wgu - Update configured Winget applications (Windows)
• scoop-install - Install configured Scoop packages (Windows)

• git-clone / gcl - Clone repositories (supports GitHub shorthand)
• git-pull / gp - Quick git pull
• git-pull-all / gpa - Pull all repositories in a workspace
• gpr - Pull changes with rebase
• gpm - Pull changes with merge

Slack Management:

• slack-status / ss - Change Slack auto-start behavior (Always/Work Hours/Disabled)
• Slack will automatically start/stop based on your configured work schedule

• config-init - Recreate all configuration file symlinks
• msys-init - Set up MSYS2 development environment (Windows)
• windows-startup - Run configured Windows startup tasks

Customization

Most user settings live under config/. Update the relevant config files, then re-run the platform install-config step to refresh links, scheduled tasks/launch agents, shortcuts, and environment settings.

Common files to edit:

• config/apps.yaml - Applications and packages to install (Windows Winget/Scoop/MSYS2)
• config/Brewfile - Packages to install (macOS Homebrew)
• config/symlink.yml - Config files linked into your system
• config/slack-status.yml - Slack startup schedule
• config/shell/ - Shell aliases, prompt, and terminal settings
• config/vscode/ - VS Code settings, keybindings, extensions, snippets, and synced state

⚠️ Important Notes

• Review Before Running: The Windows setup scripts (src/ps1-windows/, src/ps1-windows-10/) will modify system settings and remove default Windows applications. Please review these scripts before running __setup-windows.cmd / __setup-windows-10.cmd to ensure they match your preferences.

• Administrator Rights: Some Windows scripts require administrator privileges. macOS scripts may prompt for your password via sudo.

• Backup First: Consider backing up important data before running system modification scripts.