Eddy

Float trip planning for Ozarks rivers — eddy.guide. Live USGS water conditions, access points, float time estimates, hazards, and shareable trip plans, delivered as a web app and an iOS app.

What ships from this repository

• Web app + API — missouri-float-planner/: Next.js on Vercel, Supabase (PostgreSQL + PostGIS) backend. Vercel's Root Directory is this folder; nothing outside it is part of the web build.
• iOS app — eddy-ios/: Expo app consuming the web API, built with EAS. Shares code with the web app via file: dependencies on packages/ and missouri-float-planner/shared/.

Supporting directories: packages/ (shared @eddy/* modules), scripts/ + clipengine-local/ (media and social automation), design/, marketing/, and docs/ (ops runbooks, decision records, and research material).

The full map, task-routing table, and repository constraints live in CLAUDE.md — read that first when changing anything.

Quick start

Node 20 (the version CI pins). There is deliberately no root package.json; each app installs independently:

make setup-web      # npm ci in missouri-float-planner/
make setup-mobile   # npm ci in eddy-ios/  (never --legacy-peer-deps)

cd missouri-float-planner && npm run dev   # web, http://localhost:3000
cd eddy-ios && npx expo start              # iOS, from inside eddy-ios/ only

Environment variables: see the web README for .env.local and the iOS README for app config.

Validation

make help           # list all targets
make check-web      # web typecheck + lint + tests
make check-mobile   # iOS typecheck + lint
make bundle-mobile  # production iOS bundle + .easignore allowlist check
make check          # everything CI gates on

Each target mirrors app-ci.yml exactly. Web tests intentionally cover iOS and packages/ logic, so run make check-web after mobile or shared-code changes too.

Deployment constraints worth knowing before you refactor

• Vercel builds only missouri-float-planner/; the canonical condition system lives at missouri-float-planner/shared/ so the web build can reach it.
• EAS archives from the git root, filtered by .easignore — an allowlist that fully replaces .gitignore during upload. Read its header before editing; verify with python3 eddy-ios/scripts/check-easignore.py.
• Rationale for these and other structural decisions: docs/decisions/.