ueberpruefen

QUICKSTART.md

@@ -0,0 +1,152 @@
+# Quick Start Guide - Pottery Diary
+
+## 🚀 Get Running in 2 Minutes
+
+### Step 1: Start the Development Server
+```bash
+cd pottery-diary
+npm start
+```
+
+Wait for QR code to appear in terminal.
+
+### Step 2: Run on Simulator/Emulator
+
+**iOS (Mac only)**:
+```bash
+# In another terminal
+npm run ios
+```
+
+**Android**:
+```bash
+# Make sure Android emulator is running, then:
+npm run android
+```
+
+**Physical Device**:
+1. Install "Expo Go" app from App Store / Play Store
+2. Scan the QR code from the terminal
+
+### Step 3: Test the App
+
+1. **Onboarding**: Swipe through 3 welcome screens, tap "Get Started"
+2. **Create Project**:
+   - Tap "New Project"
+   - Enter title: "Test Bowl"
+   - Add tags: "bowl, cone 6"
+   - Tap "Create Project"
+3. **Add Bisque Step**:
+   - Tap "Add Step"
+   - Select "Bisque Firing"
+   - Enter Cone: "04" (temp auto-fills to 1945°F)
+   - Add notes: "Slow ramp"
+   - Tap "Save Step"
+4. **Add Glaze Step**:
+   - Tap "Add Step"
+   - Select "Glazing"
+   - Enter 2 coats
+   - Tap "Save Step"
+5. **Add Glaze Firing Step**:
+   - Tap "Add Step"
+   - Select "Glaze Firing"
+   - Enter Cone: "6" (temp auto-fills to 2232°F)
+   - Tap "Save Step"
+6. **View Timeline**: See all steps in order
+7. **Test Settings**:
+   - Go to Settings tab
+   - Toggle Temperature Unit to °C
+   - Go back to project
+   - Verify temps converted (1945°F → 1063°C, 2232°F → 1222°C)
+
+## ✅ Expected Behavior
+
+- Projects list shows "Test Bowl" with "In Progress" status
+- Project detail shows 3 steps with icons (🔥, 🎨, ⚡)
+- Cone numbers auto-fill temperatures
+- Unit conversions work instantly
+- All data persists after app restart
+
+## 🧪 Run Tests
+
+```bash
+npm test
+```
+
+Expected output: **All tests pass** (11 tests across 3 suites)
+
+## 📱 Test on Physical Device
+
+### Option 1: Expo Go (Quick)
+1. Install Expo Go app
+2. Scan QR code from `npm start`
+3. App loads in Expo Go container
+
+### Option 2: Development Build (Full Features)
+```bash
+npm install -g eas-cli
+eas login
+eas build --profile development --platform ios
+# or
+eas build --profile development --platform android
+```
+
+## 🐛 Troubleshooting
+
+### "Cannot find module 'expo-sqlite'"
+```bash
+npx expo install expo-sqlite
+npm start --clear
+```
+
+### "Metro bundler error"
+```bash
+npm start --clear
+```
+
+### TypeScript errors
+```bash
+npx tsc --noEmit
+```
+
+### Tests failing
+```bash
+npm test -- --clearCache
+npm test
+```
+
+### Database not seeding
+- Delete app from simulator/device
+- Reinstall (database auto-seeds on first launch)
+
+## 🎬 Next Steps
+
+1. ✅ Verify app runs and tests pass
+2. 📸 Add photo capture UI (expo-camera already configured)
+3. 🔍 Build glaze picker screen
+4. 📤 Implement data export
+5. 🌐 Add news feed JSON fetching
+6. 🎨 Design app icon
+7. 📱 Build with EAS (`eas build --platform all`)
+8. 🚀 Submit to App Store / Play Store
+
+## 📚 Documentation
+
+- **README.md**: Full setup and features
+- **PROJECT_SUMMARY.md**: Implementation details
+- **BUILD_INSTRUCTIONS.md**: Deployment guide
+- **docs/PRD.md**: Product requirements
+- **SECURITY.md**: Privacy and security
+- **PRIVACY.md**: CCPA compliance
+
+## 🆘 Need Help?
+
+1. Check terminal for errors
+2. Run `npm start --clear` to clear cache
+3. Delete app and reinstall
+4. Check `node_modules` folder exists (run `npm install` if not)
+5. Verify Node.js 18+ is installed (`node --version`)
+
+---
+
+**Ready?** Run `npm start` and start building! 🏺