FAQ — Engineering

Where is the source of truth for receipts?

The backend API + database. iOS is a client. Marketing does not own vault data.

What are the consumer tabs in code?

AppTab: home, bills, analysis, offers → Home · My Bills · Analysis · Offers.

Why snake_case in JSON?

Backend convention. Map explicitly in clients — do not half-convert field names.

How is money stored?

Integer cents. Format only at the edges.

Docs auth vs shopper auth?

Completely separate. Docs use DOCS_AUTH_* cookies; shoppers use API JWTs in Keychain.

Should I deploy docs from my laptop?

Not until Phase 1 chrome is reviewed. Prefer previews, then deliberate promotion. See Deploy / CI.

Where do brand tokens live?

docs/Design.md and Design language. Web tokens also map through src/app/global.css on this site.

How do I find code across repos?

Graphify against ~/.graphify/global-graph.json, then Cognee recall for decisions.

What should a new hire read first?

1. Engineering overview
2. Architecture
3. Local setup
4. Product overview
5. Surface-specific page (iOS / frontend / API)