UI / UX Spec
Design principles
- Shopkeeper-first: big tap targets, minimal typing, Hindi + English labels.
- One-handed use, fast entry (< 30s per entry).
- Material 3, clean, warm. No clutter. Numbers are the hero.
Design tokens
- Color: OKLCH-based. Primary = warm indigo/teal; "diya/credit" = warm red/orange accent,
"liya/payment" = green accent. Never gradient text.
- Typography: a clean Indian-script-friendly font (e.g. "Hind" / "Mukta" / Noto Sans) —
NOT Inter/Arial default. Tabular figures for money.
- Spacing: 8pt grid. Cards with soft shadow, 16 radius.
- Money: large, bold, tabular. Red for "owes you", green for "advance/settled".
- Respect
prefers-reduced-motion; subtle transitions only.
- Dark mode supported.
Screens
- Splash / Auth — phone entry → OTP (6-digit auto-read friendly) → in.
- Home / Dashboard
- Top card: Total outstanding (bada number) + "collected this month".
- Search bar.
- Customer list: avatar initial, name, last activity, balance (red = owes).
- Sort chips: Recent / Highest due / Name.
- FAB: "+ Naya Customer".
- Customer detail
- Header: name, phone, balance (big), call + WhatsApp-remind buttons.
- Ledger timeline: each entry — date, note, amount; credit red, payment green.
- Two big buttons bottom: "Udhaar diya (+)" and "Paisa liya (−)".
- Entry sheet: amount keypad (numeric), optional note, date (default today).
- Add/Edit customer — name, phone (optional), note.
- Reminder preview — shows the WhatsApp message before sending, one tap "Bhejo".
- Settings — shop name, owner name, logout, (future) backup/export.
Empty states
- No customers: friendly illustration + "Apna pehla customer jodo".
- Zero balance: "Sab settled ✓" green.
Micro-interactions
- Entry saved → quick toast + balance animates to new value.
- Reminder sent → checkmark animation.
Accessibility
- Contrast ≥ 4.5:1 for all text.
- Labels on all icon buttons.
- Scales with system font size.