A simple, beautiful mobile app that uses AI to analyze food photos and provide macro nutrient breakdowns.
This app has been generated using Claude Code. It's meant for demo purposes.
-
Clone and install:
git clone <repo-url> cd macro-photo npm install
-
Set up environment variables:
cp .env.example .env # Edit .env and add your API keys -
Run the app:
# iOS npm run ios # Android npm run android # Web (for testing) npm run web
macro-photo/
├── app/ # Expo Router pages (file-based routing)
├── components/ # Reusable UI components
├── lib/ # Utilities and helpers
├── services/ # API clients (Claude, OpenAI)
├── hooks/ # Custom React hooks
├── types/ # TypeScript type definitions
├── constants/ # App configuration and constants
├── assets/ # Images, fonts, etc.
├── SPEC.md # Product specification
├── TASKS.md # Development task list
└── AGENTS.md # AI agent instructions
- Framework: Expo (React Native)
- Language: TypeScript
- Routing: Expo Router (file-based)
- Styling: NativeWind (Tailwind CSS for React Native)
- AI: Claude (Anthropic) and GPT-5 (OpenAI)
You'll need API keys for:
- Claude: Get from Anthropic Console
- OpenAI: Get from OpenAI Platform
Add them to your .env file (never commit this file!).
This project uses a task-based development model:
- Check
TASKS.mdfor available tasks - Pick a task with completed dependencies
- Read the task's acceptance criteria
- Implement the feature
- Test on both iOS and Android
- Mark the task as complete in
TASKS.md
See TASKS.md for the current state of all tasks.
- Pick a task from
TASKS.md - Create a branch:
git checkout -b task-XXX-description - Implement the task following
AGENTS.mdguidelines - Test thoroughly
- Commit with clear messages
- Update task status in
TASKS.md - Create a pull request
- SPEC.md: Complete product specification, features, and design
- TASKS.md: Granular task breakdown for development
- AGENTS.md: Detailed instructions for AI coding agents
npm run android # Run on Android
npm run ios # Run on iOS
npm run web # Run on web (for testing)
npm start # Start Expo dev serverCamera not working?
- Make sure you're running on a physical device (camera doesn't work in simulators)
- Check that camera permissions are granted
API errors?
- Verify your API keys in
.env - Check your internet connection
- Ensure you have API credits/quota
Build errors?
- Delete
node_modulesandpackage-lock.json, then runnpm install - Clear Expo cache:
npx expo start -c
[Add your license here]
[Add contact information or link to issues]