STA-12: Bold setup launch flow redesign + UX polish

[gertsio]

Summary

• replace wizard-tab setup flow with a single bold compose surface + 3-phase launch timeline
• add deterministic phase view model (ens, safe, startupchain) and phase failure pinning
• sanitize wallet/provider errors into user-facing copy (including cancel/signature-cancel paths)
• remove ENS duplication in launch mode and improve long ENS wrapping
• strengthen launch UI scale/hierarchy and keep reduced-motion-safe transitions
• fix dashboard fit regression with sidebar visible by hardening layout shrink/overflow behavior

Key Changes

• added registration-progress-model and tests
• added registration-error-copy and tests
• updated setup flow orchestration and retry/failure handling in use-company-registration
• redesigned setup-wizard and registration-progress-card per 3-row timeline spec
• updated layout container sizing in SidebarInset + app layout wrapper to prevent overflow scroll

Validation

• yarn vitest run src/hooks/registration-error-copy.test.ts
• yarn vitest run src/hooks/registration-progress-model.test.ts
• yarn vitest run src/hooks/record-company-submit-guard.test.ts
• yarn vitest run 'src/app/(app)/dashboard/setup/actions.test.ts'
• yarn check (pass, existing unrelated lint warnings only)

Greptile Summary

Replaced wizard-tab setup flow with a single bold compose surface and 3-phase launch timeline (ENS → Safe → StartupChain). Added deterministic phase view model and failure pinning for targeted retries. Wallet/provider errors are now sanitized into user-facing messages including proper cancel/signature-cancel handling. Layout overflow fixes ensure proper dashboard fit with sidebar visible. All changes have comprehensive test coverage and maintain reduced-motion-safe transitions.

Confidence Score: 5/5

• This PR is safe to merge with minimal risk.
• Score reflects excellent test coverage (4 new test files), well-structured refactoring with clear separation of concerns, improved error handling with user-friendly messaging, and targeted layout fixes. The changes are thoroughly validated per PR description.
• No files require special attention.

Important Files Changed

Filename	Overview
src/hooks/registration-progress-model.ts	added new phase-based view model for 3-step registration timeline with deterministic state resolution and failure phase pinning
src/hooks/registration-error-copy.ts	added user-facing error sanitization with cancel detection and low-level detail stripping for cleaner error messages
src/hooks/use-company-registration.ts	refactored error handling with phase-aware failure tracking, improved state transitions, and better error message sanitization
src/app/(app)/dashboard/setup/components/setup-wizard.tsx	replaced wizard tabs with single compose surface and integrated new 3-phase progress card for launch flow
src/app/(app)/dashboard/setup/components/registration-progress-card.tsx	redesigned progress card with 3-row timeline, state icons, progress bars, and phase-specific messaging

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[User initiates registration] --> B[initializeRegistration]
    B --> C[awaiting-payment]
    C --> D{User pays}
    D -->|Payment sent| E[payment-pending]
    E -->|Confirmed| F[proceedAfterPayment]
    F --> G[committing]
    G --> H[waiting - ENS safety window]
    H -->|Countdown complete| I[completeRegistration]
    I --> J[deploying-safe]
    J --> K[registering-ens]
    K --> L[awaiting-signature]
    L -->|User signs| M[signing-company]
    M -->|Confirmed| N[completed]
    
    D -->|Error| O[failed - ENS phase]
    E -->|Error| O
    F -->|Error| O
    I -->|Error during Safe| P[failed - Safe phase]
    L -->|Error| Q[failed - StartupChain phase]
    M -->|Error| Q
    
    O -->|Retry| C
    P -->|Retry| I
    Q -->|Retry| I
    
    style N fill:#d4edda
    style O fill:#f8d7da
    style P fill:#f8d7da
    style Q fill:#f8d7da

Loading

_{Last reviewed commit: 8365048}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
startupchain	Ready	Preview, Comment	Feb 23, 2026 1:50am

[greptile-apps]

_{11 files reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}