A mobile app for tracking your pinball high scores with AI-powered photo scanning.
Current Version: 1.1.1
- 📸 Quick Capture: Take a photo of the score display and let AI extract the table name and score
- ✍️ Manual Entry: Fast manual entry with table search and formatted score input
- 🏆 Top 3 Scores: Track your top 3 scores for each pinball table
- Expo SDK 54 - React Native framework
- React 19.1 / React Native 0.81 - Latest stable versions
- TypeScript 5.6 - Type safety
- Expo Router 5 - File-based navigation
- Expo Camera 17 - Photo capture
- AsyncStorage 2.1 - Local data persistence
- Node.js 18+
- npm or yarn
- Expo Go app on your iPhone
# Install dependencies
npm install
# Start the development server
npm start- Install the Expo Go app from the App Store
- Run
npm startin the project directory - Scan the QR code with your iPhone camera
- The app will open in Expo Go
FlippersLog/
├── app/ # Expo Router screens
│ ├── _layout.tsx # Root layout with navigation
│ ├── index.tsx # Main scores list (shows top 3 per table)
│ ├── capture.tsx # Camera screen for photo capture
│ └── manual-entry.tsx # Manual score entry form
├── services/
│ ├── storage.ts # AsyncStorage wrapper for scores/tables
│ └── ai-vision.ts # AI vision API integration (placeholder)
├── types/
│ └── index.ts # TypeScript type definitions
└── components/ # Reusable UI components (coming soon)
✅ Quick photo capture with camera ✅ Manual score entry with formatted input ✅ Top 3 scores displayed per table ✅ Local data persistence ✅ GPS venue discovery with Pinball Map API integration ✅ Venue-specific score filtering ✅ Quick score entry from suggested venue tables 🚧 AI vision integration (placeholder - ready for API integration)
- 🤝 Social sharing
- 🎮 Pinball table database integration
- 🔍 Table search with autocomplete
The app integrates with Pinball Map API to discover nearby pinball venues and filter scores by location.
- GPS Location Detection: Uses device GPS to find nearby pinball venues within a 0.5km radius (expands to 1km if no results)
- Venue Selection: Browse and select a venue to filter your scores to only tables at that location
- Suggested Tables: When a venue is selected, see a list of available tables at that venue
- Quick Score Entry: Tap any table name in the venue list to quickly enter a score with the exact table name pre-filled
For development and testing, you can use mock GPS coordinates instead of real GPS:
File: app/venues.tsx (line 50)
To use a mock location:
const MOCK_LOCATION: typeof MOCK_LOCATIONS.the_ice_box | null = MOCK_LOCATIONS.the_ice_box;Available mock locations:
MOCK_LOCATIONS.the_ice_box- The Ice Box Arcade in SeattleMOCK_LOCATIONS.eight_bit_arcade_bar- 8-Bit Arcade Bar in SeattleMOCK_LOCATIONS.another_castle- Another Castle: Arcade Edition in Shoreline, WA
To use real GPS location:
const MOCK_LOCATION: typeof MOCK_LOCATIONS.the_ice_box | null = null;The mock locations are defined at the top of venues.tsx if you need to add more arcade coordinates.
The app is ready to integrate with Claude API or OpenAI Vision API. To enable:
- Add your API key to
services/ai-vision.ts - Implement the
analyzePhoto()function with actual API calls - Update the prompt to extract table name, manufacturer, and score
Example prompt structure:
Analyze this pinball machine photo and extract:
- Table name (exact name of the game)
- Score displayed (numeric value)
- Manufacturer if visible
Return as JSON: { tableName, score, manufacturer }
This is a personal project, but suggestions and feedback are welcome!
This app uses location data and venue information from:
- ❤️ Pinball Map (https://pinballmap.com) - Community-maintained database of pinball locations and machines worldwide
The Pinball Map API provides freely accessible data about pinball venues and machine locations, helping players discover new places to play.
MIT