Hello macOS: Setting Up the Apple Kingdom
Welcome, macOS adventurer! This quest transforms your Mac into a professional-grade development workstation. You’ll install core tooling, tune your terminal, and validate a clean, repeatable setup.
Welcome, macOS adventurer! This quest transforms your Mac into a professional-grade development workstation. You’ll install core tooling, tune your terminal, and validate a clean, repeatable setup.
🎯 Quest Objectives
Primary Objectives (Required for Quest Completion)
- Install Xcode Command Line Tools - Unlock core developer tooling
- Install Homebrew - Your macOS package manager
- Configure a Modern Terminal - iTerm2 + shell enhancements
- Verify Your Toolchain - Confirm Git, SSH, and common utilities
Bonus Objectives (Optional)
- Shell Customization - Prompt themes, aliases, and quality-of-life tweaks
- Baseline Dev Tools - VS Code, Node/Python toolchains, and git config
🗺️ Quest Prerequisites
📋 Knowledge Requirements
- Comfortable using Finder and System Settings
- Basic understanding of command line usage
🛠️ System Requirements
- macOS 12+ recommended
- Administrator access for installs
- Stable internet connection
🌍 Choose Your Adventure Platform
This quest is macOS-only. If you’re on another OS, start with:
🧙♂️ Chapter 1: Install Core Tooling
✅ Step 1: Xcode Command Line Tools
xcode-select --install
Verify after installation:
xcode-select -p
✅ Step 2: Install Homebrew
Run the official installer:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Then validate:
brew --version
brew doctor
✅ Step 3: Install Essentials via Scripts
Use the provided helper scripts (review before running):
./hb-install.sh
./hb-packages.sh
🧰 Chapter 2: Terminal & Workflow Enhancements
✅ Step 4: Install iTerm2
./iterminate2.sh
✅ Step 5: Run the macOS setup helper
./hello-mac.sh
This script walks you through common dev tooling checks and config hints.
🧪 Chapter 3: Validate Your Setup
Run these checks to confirm your environment:
git --version
ssh -V
brew list
You should see valid versions for each command.
🏁 Quest Completion Checklist
- Xcode Command Line Tools installed
- Homebrew installed and healthy (
brew doctor) - Terminal upgraded (iTerm2 + shell config)
- Git/SSH verified
🔗 Related Quests
📚 References & Resources
- Xcode Command Line Tools - Apple Developer
- Homebrew - The Missing Package Manager for macOS
- iTerm2 - macOS Terminal Replacement
- Oh My Zsh - Zsh Framework
- Git Documentation
- GitHub SSH Key Setup Guide
- Apple macOS User Guide
🕸️ Knowledge Graph
Structured wiki-links connect this quest to the IT-Journey knowledge graph. Open the Obsidian Graph View to explore connections.
Level hub: [[Level 0000 - Foundation & Init World]] Overworld: [[🏰 Overworld - Master Quest Map]] Recommended: [[Hello n00b: Your First Steps into the IT Journey]] · [[OS Selection]] Unlocks: [[VS Code Mastery Quest: Forge Your Ultimate Development Weapon]] · [[Terminal Fundamentals: Command Line Navigation Quest]] Sequel quests: [[VS Code Mastery Quest: Forge Your Ultimate Development Weapon]] Parallel quests: [[Hello Windows: Mastering the Windows Development Environment]] · [[Linux Fundamentals]] Obsidian docs: [[Obsidian Knowledge Graph and Wiki Links]]
🎁 Rewards
Badges
- 🏆 Apple Kingdom Badge
- ⚡ Homebrew Mastery Achievement
Skills unlocked
- 🛠️ macOS Package Management
- 🎯 Terminal Configuration
🕸️ Quest Network
Referenced by
- Loading…