📘 MSSU Developer Mac Setup

A clean, modern, reproducible Java + Grails + SQL development environment for macOS.

---

📑 Table of Contents

• ✨ Features
• 🚀 Quick Install
• 📁 Folder Structure
• 🧪 Validation Checklist
• 🧠 Manual Install (Optional)
• 🔧 Running Your First Project
• 🐛 Troubleshooting
• 🎉 You're Ready

---

✨ Features

• One-command environment setup (init.sh)
• Installs:
  • Homebrew + essential CLI tools
  • SDKMAN, Java 17, Grails 6
  • Oracle SQL Developer (GUI) + SQLcl (CLI)
  • iTerm2, Rectangle, AltTab
• Creates a clean development folder layout
• Provides a tuned zsh setup with aliases & quality-of-life improvements

---

🚀 Quick Install

cd ~
git clone https://github.com/Davis86t/mssu-dev-mac-setup
cd mssu-dev-mac-setup

chmod +x init.sh
./init.sh
source ~/.zshrc

---

📁 Folder Structure

~/Code/
    mssu/         # project repos

~/Sandbox/        # experiments, scratch work, learning

~/Dev/
    java/
    grails/
    databases/
        oracle/

~/Bin/
~/.config/

~/Projects/
    mssu/         # documentation, architecture notes

---

🧪 Validation Checklist

java -version
grails -version
brew --version
sql -version

---

🧠 Manual Install (Optional)

Install Oracle SQL Developer (GUI)

Oracle SQL Developer is used on campus for connecting to Oracle databases (ex: Banner).

1. Download SQL Developer for macOS from Oracle
2. Extract the zip
3. Launch the app and create a connection (you’ll need the host/port/service name + credentials)

Official downloads: https://www.oracle.com/database/sqldeveloper/technologies/download/

Note: SQLcl (installed by this repo) is the command-line companion to SQL Developer.

Install Xcode Tools

xcode-select --install

Install Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Install Brewfile packages

brew bundle --file=Brewfile

Install SDKMAN + Java + Grails

curl -s "https://get.sdkman.io" | bash
source ~/.sdkman/bin/sdkman-init.sh

sdk install java 17.0.12-tem
sdk install grails 6.0.0

---

🔧 Running Your First Project

cd ~/Code/mssu
git clone <repo>
cd <project>
./gradlew bootRun

---

🐛 Troubleshooting

Issue	Solution
Grails not found	source ~/.zshrc
SQL Developer won't launch	Download the macOS build that includes the Oracle JDK (or install a supported JDK)
Permission denied	chmod +x gradlew

---

🎉 You're Ready

Your macOS machine is now fully equipped with:

• Java 17
• Grails 6
• Oracle SQL Developer / SQLcl
• Homebrew tooling
• A polished zsh environment

Start building. 🚀