📂 Repo: quick-dev-env-setup

quick-dev-env-setup/
│
├── README.md
├── Brewfile                       # Lists all packages and casks for brew bundle.
├── setup-dev-environment.sh       # Bash script for macOS/Linux/WSL with progress bars
└── setup-windows-oneclick.ps1     # PowerShell script for Windows with progress bars

---

1️⃣ README.md

Development Environment Setup

This repository provides a quick setup for anyone setting up a development environment on a new machine.

---

Supported Operating Systems

OS	Script
Windows 10/11 (via WSL)	setup-windows-oneclick.ps1
Linux / WSL (Ubuntu)	setup-dev-environment.sh
macOS (Homebrew)	setup-dev-environment.sh

---

Tools Installed

• Visual Studio Code
• Git
• GitHub CLI (gh)
• Docker
• Terraform
• Node.js (LTS via NVM)
• Python 3.11+
• Kubectl
• Helm
• AWS CLI
• tldr pages

---

Usage Instructions

🪟 Windows (One-Click)

1. Open PowerShell as Administrator.
2. Run:

Set-ExecutionPolicy Bypass -Scope Process
.\setup-windows-oneclick.ps1

The script installs WSL (if missing), Git, and runs the Linux/macOS setup script automatically in WSL. Watch progress bars and colored messages. Logs are automatically saved.

---

🍎 macOS / Linux / WSL

1. Open Terminal.
2. Run:

chmod +x setup-dev-environment.sh
./setup-dev-environment.sh

The script detects your OS, installs all required tools, shows progress bars, and logs everything automatically.

---

🔐 Interactive Configuration

After installing tools, setup-dev-environment.sh walks you through the setup steps that can't be automated with fixed values, since they involve your personal identity/credentials:

• Git identity — prompts for user.name / user.email if not already set, and configures a credential helper (osxkeychain on macOS, credential cache on Linux/WSL).
• GitHub CLI — if gh isn't authenticated, offers to run gh auth login (browser-based device flow).
• AWS CLI — if no valid credentials are found, offers to run aws configure (you'll need an IAM access key/secret from your AWS account).

You can skip any of these prompts (n) and run the underlying command yourself later.

---

✅ Verification

The macOS/Linux/WSL script automatically checks:

git --version
gh --version
docker --version
aws --version
terraform --version
node --version
python3 --version
kubectl version --client
helm --version
code --version

It also runs deeper health checks:

• docker run hello-world — confirms Docker Desktop is actually running, not just installed.
• npm doctor — flags npm/Node environment issues.

The Windows script (setup-windows-oneclick.ps1) only verifies git, wsl, and docker itself — full tool verification happens when it runs setup-dev-environment.sh inside WSL.

---

📂 Logs

• Each run creates a timestamped log file (setup-log-YYYYMMDD-HHMMSS.txt) in the same folder.
• Use logs for troubleshooting.

---

Notes

• For Windows, always use WSL for Linux-based commands.
• Scripts are beginner-friendly for anyone setting up a new laptop or joining a new team.
• If a tool fails, consult its official documentation.

---

2️⃣ setup-dev-environment.sh (macOS/Linux/WSL)

• Bash script with progress bars and color-coded output.
• Installs all major dev tools (Git, GitHub CLI, Docker, Terraform, Node.js via NVM, Python3, Kubectl, Helm, AWS CLI).
• Interactively configures Git identity/credentials, GitHub CLI auth, and AWS credentials.
• Logs everything to a timestamped file.

---

3️⃣ setup-windows-oneclick.ps1 (Windows)

• PowerShell script with progress bars and color-coded output.
• Checks and installs WSL + Ubuntu, Git via winget.
• Copies and runs setup-dev-environment.sh inside WSL.
• Logs everything automatically.

---

✅ Features of This Repo

1. One-click installation for macOS, Linux, WSL, and Windows.
2. Color-coded output for success/failure/info.
3. Progress bars for each tool to give visual feedback.
4. Automatic logging with timestamped files for troubleshooting.
5. Verification of all installed tools at the end.

---

🚀 Quick Start

macOS / Linux / WSL

git clone https://github.com/mfaizalbe/quick-dev-env-setup.git
cd quick-dev-env-setup
chmod +x setup-dev-environment.sh
./setup-dev-environment.sh

Windows

git clone https://github.com/mfaizalbe/quick-dev-env-setup.git
cd quick-dev-env-setup
Set-ExecutionPolicy Bypass -Scope Process
.\setup-windows-oneclick.ps1

Watch progress bars for each tool and check the log file if anything fails.