Project

    Maintain iOS

    Maintain is a native iPhone app and backend scaffold for weight maintenance after loss or major body transition. The product is intentionally framed around staying inside a user-defined maintenance range, understanding short- and long-term fluctuation, and keeping GLP-1 medication context descriptive rather than prescriptive.

    Narrative

    01

    Maintenance instead of loss

    Maintain is a native iPhone app for people who are trying to stay steady after weight loss or another major body transition. The project is built around a user-defined maintenance range, short- and long-term fluctuation awareness, and GLP-1 context that stays descriptive rather than prescriptive. Its core product choice is to make the question "am I still inside my range?" easier to answer without turning normal day-to-day movement into failure.

    System surfaces

    Native iOS app

    Maintenance users and internal testers

    SwiftUI iPhone app with sign-in, onboarding, Home, Log, Trends, Activity, and Profile surfaces.

    Staging API

    Developers and TestFlight/preview validation

    Cloudflare Worker staging endpoint for authenticated profile, sync, export, and route smoke verification.

    Visual checkpoint packet

    Product and QA reviewers

    Repo-owned simulator screenshot harness covering the core native app surfaces.

    Implementation stack

    iOS

    • • SwiftUI
    • • SwiftData
    • • Swift Charts
    • • HealthKit
    • • TipKit
    • • XcodeGen

    Backend

    • • Cloudflare Workers
    • • Hono
    • • Zod
    • • Neon Postgres
    • • Neon Auth-compatible JWKS
    • • R2
    • • Queues

    Verification

    • • Makefile gates
    • • XCTest UI capture
    • • SnapshotTesting
    • • Vitest
    • • backend staging smoke
    • • docs manifest/link checks

    Evidence

    17 artifacts grouped by type so each kind of proof can be scanned on its own.

    Data models

    1 artifact
    data modelWork date: Date unknown

    Maintain app and backend loop

    The native app captures maintenance context locally, syncs authenticated changes through Worker routes, and uses staging/TestFlight gates before broader release decisions.

    8 entities1 diagram

    Workflows

    1 artifact
    workflowWork date: Date unknown

    Maintain validation and surface-capture loop

    How Maintain turns native iOS and backend work into reviewable evidence: regenerate the Xcode project, run simulator surface capture, verify docs/backend/iOS gates, check staging when credentials are available, and keep TestFlight/App Store blockers explicit before release decisions.

    8 steps1 record

    Images

    8 artifacts
    Activity — Maintain iOSimage

    Activity

    Home — Maintain iOSimage

    Home

    Log — Maintain iOSimage

    Log

    Onboarding — Maintain iOSimage

    Onboarding

    Profile export ready — Maintain iOSimage

    Profile export ready

    Profile HealthKit connected — Maintain iOSimage

    Profile HealthKit connected

    Sign-in gate — Maintain iOSimage

    Sign-in gate

    Trends — Maintain iOSimage

    Trends

    Notes

    7 artifacts
    noteWork date: Date unknown

    Maintain product brief

    Product framing for a private iPhone app centered on maintenance range confidence, fluctuation awareness, GLP-1 context, and personal maintenance history.

    1 topic1 scope
    noteWork date: Date unknown

    Maintain MVP requirements

    MVP requirements for onboarding, customizable maintenance range setup, local persistence, dashboard interpretation, logging, trends, activity, profile, and backend scaffold scope.

    1 topic1 scope
    noteWork date: Date unknown

    Maintain iOS architecture

    Client architecture showing the SwiftUI app shell, SwiftData container, AppRootView states, AppModel coordination, HealthKit import, export manifests, and local-first sync seams.

    1 topic1 scope
    noteWork date: Date unknown

    Maintain backend architecture

    Worker and Neon backend architecture for authenticated profile, range, weights, dose events, workouts, schedules, sync cursor, trends, and export flows.

    1 topic1 scope
    noteWork date: Date unknown

    Maintain environments and deployment state

    Environment evidence for local, preview/staging, and intended production API/auth targets, including the recorded production reachability and Worker-account blockers.

    1 topic1 scope
    noteWork date: Date unknown

    Maintain Home surface evidence

    Screenshot evidence of the returning-user Home surface with maintenance status, target/drift/recent values, trend chart, HealthKit pulse, and tab navigation.

    1 topic1 scope
    noteWork date: Date unknown

    Maintain current-state journey audit

    Journey audit evidence covering the sign-in gate, onboarding, returning-user tab shell, HealthKit states, export states, and unverified hosted/live-route boundaries.

    1 topic1 scope

    Key dates

    2026-04-04
    MVP product framing

    Product brief and PRD describe the maintenance-specific user, range confidence, fluctuation awareness, medication context, and private-by-default posture.

    2026-05-03
    Mainline validation closeout

    Maintain source docs record merged Logbook, branch recenter, sync, and clean-main validation repair streams.

    2026-06-01
    Hyphenomenon review refresh

    Maintain is reviewed from current source evidence as a first-class project candidate with the public record focused on product, app surface, architecture, and release boundaries.