Skip to content

HOW_TO_RUN.md

Latest commit

 

History

History
62 lines (48 loc) · 1.93 KB

HOW_TO_RUN.md

File metadata and controls

62 lines (48 loc) · 1.93 KB

🚀 How to Run NutriClassify App

✅ The app is currently running!

🌐 For Web Browser (Easiest for you):

  1. Open your browser and go to: http://localhost:19006
  2. The app should load automatically in your browser
  3. You can use it just like a regular website!

📱 For Mobile (using Expo Go app):

  1. Download Expo Go app from App Store or Play Store
  2. Make sure your phone is on the same WiFi as your computer
  3. In the terminal, you'll see a QR code
  4. Scan the QR code with:
    • iPhone: Camera app
    • Android: Expo Go app scanner

💻 Commands to Remember:

# To start the web version (already running):
pnpm expo start --web

# To start for mobile:
pnpm expo start

# If you see any errors, restart with:
pnpm expo start -c  # This clears the cache

🎮 How to Navigate the App:

  1. Bottom Navigation Tabs:

    • Foods 🍲 - Browse Nigerian foods with nutrition info
    • Recipes 📖 - View traditional recipes with instructions
    • Search 🔍 - Search across all foods and recipes
    • Learn 📚 - Nutrition education with African context
    • Profile 👤 - Track your nutrition and shopping list

  2. Key Features to Try:

    • Tap any food to see detailed nutrition
    • Heart icon to favorite items
    • Filter by categories and nutritional classes
    • Add ingredients to shopping list from recipes
    • Track daily nutrition intake in Profile

🔧 Troubleshooting:

If the web version doesn't load:

  1. Make sure you're on http://localhost:19006 (not 8081)
  2. Try refreshing the page (Cmd+R or F5)
  3. Check browser console for errors (Right-click → Inspect → Console)

📝 Current Status:

  • ✅ All components loaded
  • ✅ 12 Nigerian foods in database
  • ✅ 8 traditional recipes
  • ✅ Navigation working
  • ✅ React versions matched (19.1.1)
  • ✅ Web server running on port 19006

Enjoy exploring Nigerian nutrition with NutriClassify! 🇳🇬