Twill Brain

#1140 merchant creation UX change

2 min read

#1140 — merchant creation UX change

Repo: Twill-AI/twill-ai-ui State: open | Status: open Assignee: raymondehizoba

Created: 2026-03-17 · Updated: 2026-03-19

Description

Context

When a user creates a merchant by uploading documents, the current flow would navigate them into an editable form, before AI extraction finishes. There is no feedback on extraction progress, and the user has no way to know when fields are populated. This ticket implements the Phase 1 merchant creation UX: lock the form during extraction, show real-time document processing progress, and unlock once complete.

Discussed in Weekly UI/UX sync. Backend WebSocket events are being added in a separate facade ticket.

1. Disable form fields during AI extraction

After the user clicks “Create Merchant” and uploads documents:

  • Navigate to the merchant application page
  • Disable all form fields while extraction is in progress
  • Fields remain read-only until the backend signals completion (or timeout)
  • No partial editing allowed during Phase 1 (multi-actor editing is Phase 2)

2. Default to full-screen chat view with progress messaging

  • On merchant creation with documents, open the full-screen chat panel by default
  • Display a message: “AI is working on extracting fields from your documents. You can navigate away and we’ll notify you when it’s ready, or sit back and watch.”
  • The chat view is the primary interface while extraction runs

3. Per-document status indicators

Show real-time status for each uploaded document:

  • Uploading (blinking)→ **Anal

Notes

Add implementation notes, blockers, and context here

Add wikilinks to related people, meetings, or other tickets

Graph View