v1.9.0 - UX Improvements

UX Audit & Improvements

Streamlined user workflow with context-aware navigation and keyboard shortcuts.

Changes

Upload Page

• Primary CTA changed from "Continue" to "Select items now" - directs users forward in the flow
• Added secondary "Back to session" option

Session Page - Context-Aware Actions

• No receipts: Primary action = "Upload receipt"
• Has receipts, nothing claimed: Primary action = "Select your items"
• Has claimed items: Primary action = "View who owes what"
• Secondary actions (My items, Edit, Add receipt) grouped in compact row

Select Page

• Removed duplicated claimed items list at bottom
• Added minimal "View your N claimed items →" link
• Added keyboard shortcuts:
  • ← or N = Not mine
  • → or Y or Space = Mine
  • ↑ or S = Share
  • ↓ or K = Skip
  • Backspace or Ctrl+Z = Undo
• Added keyboard hint text for discoverability

Optimized User Flow

Home → Create → Upload → Select Items Now → Summary
                         (auto-suggested)

The key improvement is reducing cognitive load by showing the right primary action based on where the user is in their workflow.

v1.8.1 - Hide claimed items

Fix

• Hide claimed items: Items that have been claimed by anyone are now hidden from the Tinder-style selection interface
• Use the "My items" page to view and edit your claimed items

v1.8.0 - My Items Page

New Features

My Items Page

New dedicated page to view and manage your claimed items:

• View claimed items - See all items you've claimed, grouped by receipt
• Edit quantity - Change how many of an item you're claiming (for items with quantity > 1)
• Remove claims - Unclaim items you no longer want
• Shared item details - See who you're sharing items with

UI Improvements

• Added "My items" button to session page with count of claimed items
• Quick navigation to claim more items or view summary from My Items page

v1.7.0 - Receipt Metadata

New Features

Currency Editor

• Change receipt currency after OCR scan or in the Edit receipts page
• Extended currency support: added RSD, UAH, ILS, SGD, HKD, NZD, ZAR, AED, SAR, VND, IDR, MYR, PHP

Receipt Name & Note

• Receipt name: Give your receipts a custom name (e.g., "Dinner at Mario's")
• Receipt note: Add notes that will be shown during item selection (e.g., "Birthday dinner, Alice paid for dessert")
• Auto-filled from establishment name when detected

Establishment Detection

• OCR now auto-detects the restaurant/venue name from the receipt header
• Shown in the upload page and edit page

UI Improvements

• Receipt name and note are displayed in the Tinder-style selection cards
• Edit page shows receipt info (name, note, establishment)
• Currency selector available in both upload and edit pages

v1.6.0 - Undo feature

New Features

• Undo button: Go back to the previous item if you accidentally tapped the wrong button
  • Works for all actions: Not mine, Skip, Mine, Share
  • Claims are properly reverted via API
  • Button is disabled when no actions to undo

v1.5.1 - Bug fix

Bug Fixes

• Select items page: Remove duplicate action buttons from SwipeCard component

The SwipeCard had its own action buttons that duplicated the 4-button layout (Not mine, Skip, Mine, Share) added in v1.3.0.

v1.5.0 - Receipt Translation for Travel

What's New

Receipt Item Translation 🌍

Perfect for international travel! Translate receipt items to your preferred language:

• 18 languages supported: English, Russian, Spanish, French, German, Italian, Portuguese, Chinese, Japanese, Korean, Thai, Vietnamese, Arabic, Hindi, Turkish, Polish, Ukrainian, Dutch
• Session-level setting: Set once, applies to all new receipts
• Automatic translation: Items are translated during OCR processing
• Easy toggle: Globe icon selector in session page

Example use case: You're traveling in Japan, scan a receipt in Japanese, and items appear translated to English (or any other language).

How to Use

1. Open your session
2. Find the "Translate receipt items" dropdown with the 🌐 globe icon
3. Select your preferred language
4. Upload receipts - items will be automatically translated!

API

New endpoint to set translation:

curl -X PATCH "https://whoate.app/api/sessions/CODE" \
  -H "Content-Type: application/json" \
  -d '{"participantId": "YOUR_ID", "translateTo": "en"}'

Set translateTo to empty string ("") to disable translation.

Full Changelog

• feat: add receipt item translation for international travel
• Updated skill file with translation endpoint
• Updated API documentation with all supported languages

v1.4.0 - Edit OCR Results & Tax Toggle

What's New

Edit OCR Results

After uploading a receipt, you can now edit the recognized items before continuing:

• Click "Edit" button to enter edit mode
• Modify item names, quantities, and prices
• Add new items or delete existing ones
• Change tax and tip amounts
• Live total preview while editing
• Save changes or cancel to revert

Tax Included Toggle

New toggle "Tax included in prices?" appears after receipt upload:

• OFF (default): Tax will be split proportionally among participants
• ON: Tax is already included in item prices, won't be added on top

This fixes the issue where some receipts showed higher totals because tax was being double-counted.

Full Changelog

• feat: allow editing OCR results after recognition
• feat: add tax included toggle for receipts

v1.3.0 - Skip & Review Later

What's New

Skip & Review Later

• New "Skip" button - Skip items you're unsure about and review them later
• "Not mine" button - Permanently mark items that aren't yours
• After going through all items, skipped items are automatically shown for review
• Skip counter shows how many items are pending review

Improved Item Selection UI

• Action buttons below swipe card - Tap buttons instead of swiping:
  • ❌ Not mine (red) - permanently skip
  • ⏭️ Skip (gray) - review later
  • ✓ Mine (black) - claim for yourself
  • 👥 Share - split with others
• Labels under each button for clarity

Bug Fixes

• Fixed "No items claimed" bug - Summary page now correctly shows "All settled!" when items are claimed but there are no debts (e.g., when the payer claims their own items)

Full Changelog

• feat: separate "Not mine" and "Skip" actions
• feat: add action buttons below swipe card
• fix: show 'All settled' when claims exist but no debts

v1.2.0 - Quantity Selection

What's New in v1.2.0

Quantity Selection for Multi-Item Claims

When claiming items with quantity > 1 (e.g., "Ramen ×2"), you can now specify exactly how many are yours.

New UX Flow:

• Swipe right on multi-quantity item → quantity dialog appears
• Select how many you want (1, 2, etc.)
• See real-time price breakdown
• Claimed items show "(1 of 2)" notation

Receipt & Item Editing

New edit page at /session/[code]/edit allows:

• View all receipts in session
• Edit item name, quantity, and price
• Delete individual items
• Delete entire receipts (uploader only)

Health Check Endpoint

• GET /api/health returns server status, uptime, and version
• Useful for monitoring and container orchestration

API Changes

New Endpoints

• DELETE /api/sessions/:code/receipts/:receiptId — Delete a receipt

Updated Endpoints

• POST /api/sessions/:code/claim — Now accepts claimedQuantity parameter
• PATCH /api/sessions/:code/receipts — Edit receipt items

New Claim Fields

{
  "type": "individual",
  "claimedQuantity": 1  // How many of this item (e.g., 1 of 2 ramens)
}

Documentation

• Updated API.md with all new endpoints and examples
• Updated skill file for Claude Code integration
• Bumped version to 1.2.0

---

Full Changelog: v1.1.0...v1.2.0