How kemgp/tidetrace works
TideTrace is a community conservation app for members to explore approved Traces and Tides, submit Traces for review, and follow moderation updates. The main connected workflow is sign-in, draft submission with optional evidence photos, staff review, and publication or revision; members can then browse saved Traces and lessons. The React client also includes admin and moderator capabilities, while the Node API exposes the persistent workflows over Supabase. Dashboard actions and statistics remain demo-backed. Relationships for unsampled areas reflect README descriptions; source excerpts do not reveal every endpoint-to-database interaction.
Main entry points: AppContext.jsx Session and app state · app.js HTTP API · data.js Data API client · App.jsx App routes
Components 31
Member experience
- App routes
client/src/App.jsx - Session and app state
client/src/context/AppContext.jsx - Sign-in flows
client/src/pages/auth - Auth API client
client/src/api/auth.js - Session manager
client/src/api/session.js - Remote data hook
client/src/hooks/useRemoteData.js - Loading and errors
client/src/components/RemoteState.jsx - Loading skeletons
client/src/components/SkeletonLoader.jsx - Data API client
client/src/api/data.js - Trace browsing and drafts
client/src/pages/user/traces - Trace photo previews
client/src/components/TracePhotos.jsx - Tide lessons
client/src/pages/user/tides - Member notifications
client/src/pages/user/notifications/Notifications.jsx - Profile and account
client/src/components/ProfileNameForm.jsx - Demo dashboard data
client/src/data/mockData.js
Staff workflows
- Trace review
client/src/pages/moderator/ReviewTraces.jsx - Report review
client/src/pages/moderator/ManageReports.jsx - Admin management
client/src/pages/admin
API services
- HTTP API
server/src/app.js - Authentication routes
server/src/routes/auth.js - Content routes
server/src/routes/content.js - Staff routes
server/src/routes/staff.js - Media routes
server/src/routes/media.js - Request authentication
server/src/middleware.js - Request validation
server/src/validation.js
Persistence
- Supabase gateway
server/src/supabase.js - Supabase PostgreSQL
- Supabase Storage
- Supabase Auth
Other components
- Member
- Moderator or admin
Connections 33
- Member → App routes: uses
README.md - Moderator or admin → App routes: uses
README.md - App routes → Session and app state: provides state
client/src/App.jsx - App routes → Sign-in flows: routes to
client/src/App.jsx - App routes → Trace browsing and drafts: routes to
client/src/App.jsx - Session and app state → Auth API client: authenticates with
client/src/context/AppContext.jsx - Session and app state → Session manager: manages sessions
client/src/context/AppContext.jsx - Session and app state → Data API client: requests data
client/src/context/AppContext.jsx - Remote data hook → Session and app state: reads through
client/src/hooks/useRemoteData.js - Remote data hook → Loading and errors: reports state
client/src/pages/user/tides/Tides.jsx - Loading and errors → Loading skeletons: renders
client/src/components/RemoteState.jsx - Trace browsing and drafts → Data API client: loads and saves
README.md - Trace browsing and drafts → Trace photo previews: previews evidence
client/src/components/TracePhotos.jsx - Tide lessons → Data API client: loads lessons
README.md - Member notifications → Session and app state: uses app state
client/src/pages/user/notifications/Notifications.jsx - Session and app state → Demo dashboard data: loads demo data
client/src/context/AppContext.jsx - Trace review → Data API client: reads and decides
README.md - Report review → Trace photo previews: renders evidence
client/src/pages/moderator/ManageReports.jsx - Admin management → Data API client: manages content
README.md - HTTP API → Authentication routes: mounts
server/src/app.js - HTTP API → Content routes: mounts
server/src/app.js - HTTP API → Staff routes: mounts
server/src/app.js - HTTP API → Media routes: mounts
server/src/app.js - HTTP API → Request authentication: installs
server/src/app.js - Authentication routes → Supabase gateway: authenticates via
server/src/routes/auth.js - Auth API client → Authentication routes: calls
README.md - Data API client → HTTP API: calls API
README.md - Request authentication → Supabase gateway: creates data client
server/src/middleware.js - Request authentication → Request validation: uses
server/src/routes/auth.js - Supabase gateway → Supabase Auth: accesses
README.md - Supabase gateway → Supabase PostgreSQL: reads and writes
README.md - Media routes → Supabase Storage: uploads evidence
README.md - Staff routes → Supabase PostgreSQL: moderates records
README.md