init project

docs/USB_BOOT_INSTRUCTIONS.md

@@ -0,0 +1,121 @@
+# 🍪 CODE CRISPIES Workshop
+## USB Boot Instructions
+
+### 📋 Quick Reference Card
+
+**Your assigned server:** `__________.codecrispies.es`
+**Workshop WiFi:** `CODE_CRISPIES_GUEST` / Password: `workshop2024`
+
+---
+
+## 💻 How to Boot from USB Drive
+
+### Step 1: Insert USB Drive
+- Insert the CODE CRISPIES workshop USB drive
+- Do NOT remove it until workshop ends
+
+### Step 2: Boot from USB
+
+#### 🖥️ **Desktop PC / Most Laptops**
+1. **Restart** your computer
+2. **Press and HOLD** one of these keys immediately as it starts:
+   - `F12` (most common)
+   - `F11` 
+   - `F9`
+   - `ESC`
+3. Select **USB Drive** or **UEFI: USB Drive** from boot menu
+4. Press `Enter`
+
+#### 🍎 **Mac (Intel)**
+1. **Restart** your Mac
+2. **Press and HOLD** `Option` (⌥) key immediately
+3. Select the **USB drive** (may show as "EFI Boot")
+4. Press `Enter`
+
+#### 🍎 **Mac (Apple Silicon M1/M2)**
+1. **Shut down** completely
+2. **Press and HOLD** the power button until you see startup options
+3. Select the **USB drive** option
+4. Click **Continue**
+
+#### 🔧 **If Boot Menu Doesn't Appear**
+
+**Windows PC:**
+1. Boot into Windows
+2. Hold `Shift` + click **Restart**
+3. Choose **Troubleshoot** → **Advanced** → **UEFI Firmware**
+4. Find **Boot Order** settings
+5. Move **USB Drive** to top of list
+6. Save and exit
+
+**Popular Manufacturer Keys:**
+- **Dell:** `F12`
+- **HP:** `F9` or `ESC` then `F9`
+- **Lenovo:** `F12` or `Fn + F12`
+- **ASUS:** `F8` or `ESC`
+- **Acer:** `F12`
+- **MSI:** `F11`
+- **Samsung:** `F2` then navigate to Boot tab
+- **Toshiba:** `F12`
+
+---
+
+## ✅ What You Should See
+
+1. **NixOS Boot Screen** appears
+2. System loads (takes 30-60 seconds)
+3. **Desktop environment** starts automatically
+4. **Terminal opens** with CODE CRISPIES welcome message
+5. You see available servers and commands
+
+---
+
+## 🚀 Getting Started Commands
+
+```bash
+# Connect to your assigned server
+connect hopper
+
+# See available app recipes  
+recipes
+
+# Get help
+help
+```
+
+---
+
+## 📱 Mobile Hotspot Instructions
+**If WiFi isn't working:**
+
+**iPhone:**
+Settings → Personal Hotspot → Turn On
+Name: iPhone, Password: (ask facilitator)
+
+**Android:**
+Settings → Network → Hotspot & Tethering → Mobile Hotspot
+Name: Android, Password: (ask facilitator)
+
+---
+
+## 🆘 Troubleshooting
+
+❌ **"No bootable device"**
+→ Try different F-key (F11, F9, ESC)
+→ USB drive may not be properly inserted
+
+❌ **Mac won't boot USB**  
+→ USB drive might need to be reformatted for Mac
+→ Ask facilitator for Mac-compatible USB
+
+❌ **Boots to Windows/Mac instead**
+→ You didn't press the boot key fast enough
+→ Restart and try again immediately
+
+❌ **Terminal doesn't open**
+→ Click terminal icon in taskbar
+→ Or press `Ctrl + Alt + T`
+
+❌ **Can't connect to internet**
+→ Try different WiFi network
+→ Use mobile hotspot as backup