pottery-diary/QUICKSTART.md

Quick Start Guide - Pottery Diary

🚀 Get Running in 2 Minutes

Step 1: Start the Development Server

cd pottery-diary
npm start

Wait for QR code to appear in terminal.

Step 2: Run on Simulator/Emulator

iOS (Mac only):

# In another terminal
npm run ios

Android:

# 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

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)

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'"

npx expo install expo-sqlite
npm start --clear

"Metro bundler error"

npm start --clear

TypeScript errors

npx tsc --noEmit

Tests failing

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! 🏺