A minimalist photo journal for capturing one moment a day.

SnapLog is a local-first photo diary built with Expo and React Native. Take a photo, add a caption, and build a visual timeline of your life. Everything stays on your device -- no accounts, no cloud, no complexity. Optional AI-powered photo descriptions are available when an OpenAI API key is configured.

• Settings persistence -- reminder preferences now survive app restarts via SecureStore
• Error recovery -- graceful error UI when database initialization fails instead of hanging
• Storage cleanup -- photo files are deleted from disk when entries are removed
• Photo sharing -- share now sends the actual image instead of just text
• Expo Go support -- camera screen gracefully degrades with a clear message in Expo Go
• Targeted notifications -- daily reminder uses a specific identifier instead of cancelling all notifications
• Responsive layout -- journal grid adapts to screen size changes and split view
• Stronger IDs -- entry IDs use expo-crypto UUID instead of timestamp-based generation
• CI improvements -- lint job now runs expo lint instead of duplicating type-check
• Plugin config -- expo-camera and expo-notifications added to app.json plugins

• Daily photo capture with front/back camera and flash control
• Journal feed in a two-column masonry grid with pull-to-refresh
• Entry detail view with full photo, caption, date, and share
• AI photo descriptions via OpenAI Vision (optional, gated on env var)
• Daily reminder notifications with configurable time
• Offline-first with SQLite persistence -- works without network
• Clean, warm UI with a custom theme and smooth transitions

• Node.js 20+
• Expo CLI (npx expo)
• iOS Simulator (macOS) or Android Emulator, or Expo Go on a physical device
• For full native features (camera, notifications): a development build via npx expo run:ios or npx expo run:android

git clone https://github.com/TMHSDigital/Demo-Mobile-App.git
cd Demo-Mobile-App
npm install
npx expo start

Scan the QR code with Expo Go, or press i for iOS Simulator / a for Android Emulator.

1. Install Expo Go on your phone
2. Run npx expo start on your machine
3. Scan the QR code from the terminal output
4. For a development build with full native module access, run npx expo run:ios or npx expo run:android

SnapLog can generate short, journal-style descriptions of your photos using OpenAI Vision.

1. Copy .env.example to .env
2. Add your OpenAI API key:

   EXPO_PUBLIC_OPENAI_KEY=sk-...
   

3. Restart the dev server

An "AI Describe" button appears on the photo preview screen when the key is configured.

app/                    # Expo Router screens
  (tabs)/               # Bottom tab navigator
    index.tsx           # Journal feed (FlatList grid)
    camera.tsx          # Camera capture
    settings.tsx        # Settings with reminders + about
  entry/[id].tsx        # Entry detail view
components/             # Shared UI components
lib/                    # Business logic
  database.ts           # SQLite CRUD operations
  store.ts              # Zustand state management
  ai.ts                 # OpenAI Vision client
  notifications.ts      # Push notification helpers
  permissions.ts        # Permission request helpers
  types.ts              # TypeScript interfaces
constants/theme.ts      # Design tokens (colors, spacing, typography)

Data flows from the camera through PhotoPreview (which copies photos to the document directory and persists entries via the Zustand store backed by SQLite) into the journal feed. The store is the single source of truth, with SQLite as the persistence layer.

This app was built using the Mobile App Developer Tools Cursor plugin. It exercises 12 of the 20 skills:

MIT