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

  1. Splash / Auth — phone entry → OTP (6-digit auto-read friendly) → in.
  2. 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".
  3. 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).
  4. Add/Edit customer — name, phone (optional), note.
  5. Reminder preview — shows the WhatsApp message before sending, one tap "Bhejo".
  6. 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.