# 🍎 MACSTARTER

*Fresh Mac → fully loaded, without pissfarting around in terminal for hours.*

Little sibling of [UltraBunt](https://github.com/type-two/ultrabunt). Was once a fast
LAMP/WordPress installer for Intel & Apple Silicon Macs — now it's a full first-time
Mac setup script with UltraBunt-style checklist menus. (The WordPress bit is still
in there as a category, for old times' sake.)

## 🚀 Quick start

On a brand new Mac (Apple Silicon or Intel):

```bash
git clone https://gitea.partly.party/monster/MACSTARTER.git
cd MACSTARTER
./macstarter.sh
```

That's it. The script bootstraps everything it needs itself:
Xcode Command Line Tools → Homebrew → menus.

Pick **FULL SEND** from the main menu to install every recommended item in one go,
or dive into categories and tick exactly what you want. Safe to re-run —
everything checks before it installs.

```bash
./macstarter.sh --catalog   # just print everything it can install
```

## 🎪 Categories

| Category | Highlights |
|---|---|
| **Core CLI tools** | git, jq, ripgrep, fzf, htop, btop, real rsync, bat, eza, tmux… |
| **Dev tools & AI CLIs** | node, GitHub CLI, Claude Code, Antigravity CLI/IDE |
| **Network & sync** | Tailscale, rclone, nmap, mtr |
| **Media** | ffmpeg, yt-dlp, imagemagick, VLC |
| **Android** | adb + fastboot (platform-tools), scrcpy |
| **Apple dev** | Full Xcode via App Store (license accept + first-run handled) |
| **GUI apps** | Brave, Warp, Raycast, Rectangle… |
| **macOS tweaks** | natural scrolling OFF, show extensions/hidden files, fast key repeat, screenshots to ~/Screenshots, no .DS_Store litter |
| **Keys & Tailscale network** | ed25519 SSH key + keychain agent, ~/.ssh/config defaults, Tailscale login/join, CLI alias |
| **WordPress (macpress classic)** | php, mariadb, wp-cli, one-shot local WP site |

## 📝 Notes

- Full Xcode needs you signed in to the App Store first (it's ~12GB, go make a coffee).
- Tailscale join opens the menu bar app for login — the script picks up once you're in.
- The SSH key step copies your new public key to the clipboard, ready to paste into
  your tailnet boxes or GitHub.
- Scrolling/keyboard tweaks fully apply after you log out and back in.
- Everything logs to `~/macstarter-install.log`.

## ✅ Install policy

Apps install via `brew` (formulae + casks) or `mas` (App Store) only.
No curl-pipe-bash randomness beyond Homebrew's own installer.