Greenlens/CLAUDE.md

CLAUDE.md

This repository contains the GreenLens mobile app, the Express backend, and the self-hosted landing/deployment stack.

Commands

Mobile app

npm install
npm run start
npm run android
npm run ios
npm run test

Backend

cd server
npm install
npm run start
npm run rebuild:batches
npm run diagnostics

Production iOS builds

npx eas-cli build:version:set -p ios
npx eas-cli build -p ios --profile production
npx eas-cli submit -p ios --latest

Architecture

Mobile app

• Expo Router entrypoint: app/_layout.tsx
• Global app state: context/AppContext.tsx
• Backend HTTP client: services/backend/backendApiClient.ts
• In-app fallback mock: services/backend/mockBackendService.ts

Backend

Single Express server in server/index.js with supporting modules in server/lib/:

• postgres.js for PostgreSQL access
• sqlite.js as a compatibility shim re-exporting the PostgreSQL layer
• plants.js for plant catalog persistence and diagnostics
• auth.js for JWT auth
• billing.js for credits, RevenueCat, Stripe, and idempotency
• openai.js for scan and health-check model calls
• storage.js for MinIO/S3 object uploads

Primary backend environment variables:

DATABASE_URL
POSTGRES_HOST
POSTGRES_PORT
POSTGRES_DB
POSTGRES_USER
POSTGRES_PASSWORD
JWT_SECRET
OPENAI_API_KEY
STRIPE_SECRET_KEY
MINIO_ENDPOINT
MINIO_ACCESS_KEY
MINIO_SECRET_KEY
MINIO_BUCKET
MINIO_PUBLIC_URL

Landing and deployment

greenlns-landing/ is a Next.js 16 app built with output: 'standalone'.

The production-style stack lives in greenlns-landing/docker-compose.yml and includes:

• caddy for TLS and reverse proxy
• landing for the Next.js app
• api for the Express backend
• postgres for persistent app data
• minio for object storage

greenlns-landing/Caddyfile routes:

• / to the landing app
• /api/*, /auth/*, /v1/*, /health, /plants/* to the Express API
• /storage/* to MinIO

Data model notes

• PostgreSQL is the source of truth for server persistence.
• Nested plant metadata such as categories and careInfo uses JSONB.
• Billing idempotency responses also use JSONB.
• SQL placeholders use PostgreSQL syntax: $1, $2, ...