Yuvomi-App/docs/native-parity.md

Native parity tracker

Acceptance contract

Native means native screens, forms, lists, navigation and interaction. Android uses Kotlin/Compose; iOS uses SwiftUI. PWA HTML/JavaScript is not embedded as the application surface. The PWA is the design/behavior reference, not the renderer.

Reference: unmodified upstream 2.78.0, 10bfef7686ed7303b4c74c7fcc55a5eb16356c9d. The scope includes its thirty page modules, settings leaves, permissions, dashboard customization and cross-module workflows. Third-party web extensions need an explicit native integration design; arbitrary server-installed HTML cannot silently become a native module.

Use these states honestly:

• Slice: real native UI/API interaction exists, with the listed limitations.
• Pending: not implemented. No fake screen, raw-JSON editor or WebView fallback.
• Parity accepted: requires functional and visual evidence on both platforms. No module currently has this status.

Page inventory

Upstream page	Native status	Work still required before parity
login	Slice: password + TOTP/recovery step	OIDC/provider policy, recovery/error UX, localization, visual comparison
setup	Slice: initial household creation	Full onboarding and configuration workflow
forgot-password	Pending	Native recovery request and server-capability UX
reset-password	Pending	Native reset token/confirmation flow
join	Pending	Invitations, account setup, validation
dashboard	Slice: task/calendar/shopping/note previews	All remaining widgets, user layout/options, timezone-aware presentation, quick add, wall mode
tasks	Slice: list/search/status filter/create/edit/complete/delete	Category/assignee/tag/visibility controls, recurrence, subtasks, attachments, comments, archive/history, lock UX, bulk/sync controls
shopping	Slice: lists/items/create/edit/check/delete	List rename/duplicate, categories, ordering, suggestions, live versions, prices/stores, imports/send/undo
notes	Slice: list/search/create/edit/pin/delete	Markdown/checklists, categories, note colors, ordering and concurrent edit UX
calendar	Dashboard preview only; module pending	Agenda/week/month, editing, recurrence/scopes, source calendars, timezone behavior, attachments/sync
schedule	Pending	Shift grid, roster, creation and settings
birthdays	Pending	Date/age privacy, contacts, reminders/import
contacts	Pending	Address book, editing, links/import/export
documents	Pending	Browse/search, metadata, native upload/camera/export and lifecycle tests
inventory	Pending	Items, locations, guarantees, attachments and reminders
meals	Pending	Meal plan, ingredients, household options and shopping transfer
recipes	Pending	Search/detail/editor, source import, images, pantry/shopping cross-links
pantry	Pending	Stock, batches/expiry, locations, quantity controls and shopping transfer
budget	Pending	Accounts, entries, categories, currency/amount handling and attachments
budget-plans	Pending	Plan editor, period/category matching and forecasts
budget-stats	Pending	Native charts and filters matching upstream calculations
subscriptions	Pending	Lifecycle, billing, recurrence and linked budget behavior
split-expenses	Pending	Groups, guests, balances, settlement and permission distinctions
housekeeping	Pending	Visits, tasks, time and role-gated payment data
waste	Pending	Schedules, pickup display/import and reminders
rewards	Pending	Catalog, ledger, goals, approvals and pocket-money precision
health	Pending	Medication, cycle, nutrition and capability-gated private views
health-fasting	Pending	Clock, history, capabilities and lifecycle behavior
settings	Slice: native logout/server removal only	Every relevant personal/admin settings leaf and native permissions
pair-display	Pending	Pairing protocol, display role and shared-surface privacy

Design reference

Native primitives reuse the upstream warm palette (#F5F3ED / #191816), opaque surfaces (#FFFFFF / #2B2825), violet accent, 16-point cards, 26-point auth panel, pill navigation/buttons and the exact three-circle brand geometry. These are initial design-token mappings, not proof of 1:1 visuals. Material/SF symbols, typography, sheets, adaptive layouts and module details still need comparison.

Every accepted module needs side-by-side screenshots from matching server data, light/dark and small/large text coverage, keyboard/safe-area/back behavior, read-only/denied permission cases and real API success/error tests. Android's integration test exports a synthetic-fixture native dashboard screenshot; it is not a production screenshot or a visual-parity approval.

Implementation order

1. Stabilize the current native authentication/dashboard/tasks/notes/shopping slice, including Apple SDK compilation and actual native tests.
2. Close auth/recovery/SSO and first-slice feature gaps, then accept those screens against PWA visual/behavior baselines rather than adding empty menu entries.
3. Implement calendar/family/contacts, kitchen/pantry, documents/inventory, then finance, household, rewards and health as separately tested native slices.
4. Complete settings, extensions/cross-module flows, accessibility, offline and notifications. Audit every upstream route/settings leaf before claiming parity.

Signing work retained, not released

The owner-authorized initial signing key and four Gitea repository secrets were created before the native correction. The private backup remains outside Git at /home/neste/yuvomi-signing/initial-20261021. Never print/commit its contents. The uncommitted signing-workflow changes were preserved in Git stash wip: owner-authorized signing setup paused for true native rewrite; do not apply it blindly to the new workflows. No signing-secret values belong in screenshots, test fixtures, documentation, commits or artifacts. Native signing/release work remains paused until this preview's scope is explicitly accepted.