A magical React Native game that turns grocery shopping into an exciting potion-brewing adventure! Perfect for keeping children entertained while shopping.
- 📱 Scan real product barcodes to find potion ingredients
- 🔍 Follow magical clues to find the right items
- ✨ Beautiful magical UI design
- 🎮 Fun and educational gameplay
- 🔄 Dual API support for reliable product lookups
- Node.js (v14 or higher)
- npm or yarn
- Expo Go app on your mobile device
- Clone the repository:
git clone <repository-url>
cd potion-masters- Install dependencies:
npm install
# or
yarn install- Start the development server:
npm start
# or
yarn start- Scan the QR code with your mobile device:
- iOS: Use the Camera app
- Android: Use the Expo Go app
- Start a new potion brewing session
- Follow the clues to find ingredients in the store
- Scan product barcodes to check if they match the ingredients you need
- Complete the potion by finding all ingredients
- Built with React Native and Expo
- Written in TypeScript
- Uses multiple barcode APIs for reliable product information:
- Primary: UPCitemdb API
- Fallback: OpenFoodFacts API (open-source food products database)
- Implements barcode scanning using Expo's BarCodeScanner
The app uses two APIs for product lookups:
-
UPCitemdb API (Primary)
- Free tier with no API key required
- Used as the primary product lookup service
-
OpenFoodFacts API (Fallback)
- Completely free and open-source
- No API key required
- Rich food product database with detailed information
- Used as a fallback when the primary API fails or doesn't find the product
- Includes additional food-specific data like ingredients, nutritional info, and allergens
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.