Skip to content

Agent L3 Screen Flows & User Journeys

Complete User Flow Diagrams


Flow 1: Agent Creator Journey

1.1 First-Time Creator Flow

┌─────────────┐
│ Main Website│
│   Homepage   │
└──────┬──────┘

       │ Clicks "Create Agent"

┌─────────────────┐
│ Agent Creator   │
│   Landing       │
└──────┬──────────┘

       │ Clicks "Get Started"

┌─────────────────┐
│ Connect Wallet  │
│   Modal         │
└──────┬──────────┘

       │ Wallet Connected

┌─────────────────┐
│ Step 1: Basic   │
│   Information   │
└──────┬──────────┘

       │ Fills form, clicks "Next"

┌─────────────────┐
│ Step 2: Select  │
│   Integrations  │
└──────┬──────────┘

       │ Selects integrations, clicks "Next"

┌─────────────────┐
│ Step 3: Config  │
│   Integrations  │
└──────┬──────────┘

       │ Configures, clicks "Next"

┌─────────────────┐
│ Step 4: Review  │
│   & Deploy      │
└──────┬──────────┘

       │ Reviews, clicks "Deploy"

┌─────────────────┐
│ Transaction     │
│   Confirmation  │
└──────┬──────────┘

       │ Confirms in wallet

┌─────────────────┐
│ Transaction     │
│   Pending       │
└──────┬──────────┘

       │ Waits for confirmation

┌─────────────────┐
│ Success!        │
│   Agent Created │
└──────┬──────────┘

       │ Clicks "View Agent"

┌─────────────────┐
│ Agent Detail    │
│   Page          │
└─────────────────┘

1.2 Returning Creator Flow

┌─────────────┐
│ Main Website│
└──────┬──────┘

       │ Clicks "Creator App"

┌─────────────────┐
│ Creator         │
│   Dashboard     │
│                 │
│ [My Agents]     │
│ [Create New]    │
└──────┬──────────┘

       │ Selects existing agent

┌─────────────────┐
│ Agent Config    │
│   Dashboard     │
│                 │
│ [Edit] [Test]   │
│ [Deploy Update] │
└─────────────────┘

Flow 2: Agent Investor Journey

2.1 Discovery & Investment Flow

┌─────────────┐
│ Main Website│
│   Homepage  │
└──────┬──────┘

       │ Clicks "Browse Agents"

┌─────────────────┐
│ Agent Registry  │
│   (Investor App)│
└──────┬──────────┘

       │ Searches/filters

┌─────────────────┐
│ Filtered        │
│   Results       │
└──────┬──────────┘

       │ Clicks agent card

┌─────────────────┐
│ Agent Detail    │
│   Page          │
└──────┬──────────┘

       │ Reviews agent
       │ Clicks "Provide Liquidity"

┌─────────────────┐
│ Liquidity Modal │
└──────┬──────────┘

       │ Enters amount
       │ Sees ownership preview
       │ Clicks "Deposit"

┌─────────────────┐
│ Transaction     │
│   Confirmation  │
└──────┬──────────┘

       │ Confirms in wallet

┌─────────────────┐
│ Success!        │
│   Liquidity     │
│   Provided      │
└──────┬──────────┘

       │ Redirects to portfolio

┌─────────────────┐
│ Portfolio       │
│   Dashboard     │
└─────────────────┘

2.2 Portfolio Management Flow

┌─────────────────┐
│ Portfolio       │
│   Dashboard     │
└──────┬──────────┘

       │ Views holdings
       │ Sees pending rewards
       │ Clicks "Claim Rewards"

┌─────────────────┐
│ Claim Rewards   │
│   Confirmation  │
└──────┬──────────┘

       │ Confirms transaction

┌─────────────────┐
│ Rewards Claimed │
│   Success       │
└─────────────────┘

Flow 3: CR8 Staker Journey

3.1 Staking Flow

┌─────────────┐
│ Main Website│
└──────┬──────┘

       │ Clicks "Stake CR8"

┌─────────────────┐
│ Staking Page    │
└──────┬──────────┘

       │ Views current stake
       │ Clicks "Stake" tab
       │ Enters amount
       │ Clicks "Stake CR8"

┌─────────────────┐
│ Approve Token   │
│   (if needed)   │
└──────┬──────────┘

       │ Approves in wallet

┌─────────────────┐
│ Stake Tokens    │
│   Transaction   │
└──────┬──────────┘

       │ Confirms

┌─────────────────┐
│ Staking         │
│   Success       │
└─────────────────┘

3.2 Claim Rewards Flow

┌─────────────────┐
│ Staking Page    │
└──────┬──────────┘

       │ Sees pending rewards
       │ Clicks "Claim Rewards"

┌─────────────────┐
│ Claim Rewards   │
│   Transaction   │
└──────┬──────────┘

       │ Confirms

┌─────────────────┐
│ Rewards Claimed │
└─────────────────┘

Flow 4: Agent Operator Journey

4.1 Monitoring Flow

┌─────────────┐
│ Main Website│
└──────┬──────┘

       │ Clicks "Operator App"

┌─────────────────┐
│ Operator        │
│   Dashboard     │
└──────┬──────────┘

       │ Selects agent

┌─────────────────┐
│ Agent Control   │
│   Panel         │
└──────┬──────────┘

       │ Monitors activity
       │ Views metrics
       │ Checks integration status

       │ Sees fees collected
       │ Clicks "Collect Fees"

┌─────────────────┐
│ Collect Fees    │
│   Transaction   │
└──────┬──────────┘

       │ Confirms

┌─────────────────┐
│ Fees Collected  │
│   Success       │
└─────────────────┘

Flow 5: Error & Edge Case Flows

5.1 Transaction Failure Flow

┌─────────────────┐
│ Transaction     │
│   Pending       │
└──────┬──────────┘

       │ Transaction fails

┌─────────────────┐
│ Error Message   │
│                 │
│ "Transaction    │
│  failed. Please │
│  try again."    │
│                 │
│ [Retry] [Cancel]│
└─────────────────┘

5.2 Insufficient Balance Flow

┌─────────────────┐
│ Liquidity Modal │
└──────┬──────────┘

       │ Enters amount > balance
       │ Clicks "Deposit"

┌─────────────────┐
│ Error:          │
│   Insufficient  │
│   Balance       │
│                 │
│ Available: 0.5 ETH│
│                 │
│ [Adjust Amount] │
└─────────────────┘

5.3 Wallet Not Connected Flow

┌─────────────────┐
│ Agent Registry  │
└──────┬──────────┘

       │ Tries to provide liquidity
       │ Wallet not connected

┌─────────────────┐
│ Connect Wallet  │
│   Prompt        │
│                 │
│ "Please connect │
│  your wallet to │
│  continue"      │
│                 │
│ [Connect Wallet]│
└─────────────────┘

Flow 6: Cross-App Navigation

6.1 Main Website → Apps

Main Website

    ├─→ Agent Creator App
    │   └─→ Creator Dashboard

    ├─→ Agent Operator App
    │   └─→ Operator Dashboard

    ├─→ Agent Investor App
    │   ├─→ Registry
    │   ├─→ Portfolio
    │   └─→ Staking

    └─→ Documentation
        └─→ Docs Pages

6.2 App-to-App Navigation

Creator App

    └─→ "View on Registry" → Investor App (Agent Detail)

Operator App

    └─→ "View Public Page" → Investor App (Agent Detail)

Investor App

    ├─→ "Create Agent" → Creator App
    └─→ "Operate Agent" → Operator App (if owner)

Screen State Transitions

Loading States

Empty State

    │ User action

Loading State (Skeleton)

    │ Data loads

Content State

Form States

Empty Form

    │ User types

Filling Form

    │ Validates

Valid Form → Submit → Processing → Success/Error

Transaction States

Action Button

    │ Click

Transaction Pending

    │ Wallet confirmation

Transaction Confirming

    │ Block confirmation

Transaction Success/Error

User Journey Maps

Creator Journey Map

Awareness → Interest → Consideration → Action → Retention
    │         │            │            │          │
    │         │            │            │          │
    │         │            │            │          └─→ Use dashboard
    │         │            │            │              Monitor agent
    │         │            │            │              Update config
    │         │            │            │
    │         │            │            └─→ Deploy agent
    │         │            │                 Register
    │         │            │
    │         │            └─→ Learn about platform
    │         │                 Review features
    │         │                 Check integrations
    │         │
    │         └─→ Visit website
    │              Explore docs
    │              See examples

    └─→ Discover Agent L3
         Marketing
         Word of mouth

Investor Journey Map

Discovery → Research → Invest → Monitor → Optimize
    │         │          │         │          │
    │         │          │         │          └─→ Rebalance
    │         │          │         │              Claim rewards
    │         │          │         │
    │         │          │         └─→ Track performance
    │         │          │              View earnings
    │         │          │              Check portfolio
    │         │          │
    │         │          └─→ Provide liquidity
    │         │                 Stake CR8
    │         │                 Make investment
    │         │
    │         └─→ Browse agents
    │              Compare metrics
    │              Read details
    │              Check integrations

    └─→ Find platform
         Registry
         Marketing

Key Interaction Patterns

Trigger: Button click, link click Behavior: Overlay appears, focus trap, ESC to close States: Open, closing, closed

Form Patterns

Multi-step: Progress indicator, back/next navigation Validation: Real-time or on blur Submission: Loading state, success/error feedback

List Patterns

Pagination: Page numbers or "Load More" Infinite Scroll: Auto-load on scroll Filtering: Instant or debounced

Card Patterns

Hover: Subtle elevation, border change Click: Navigate to detail page Selection: Checkbox for bulk actions


Persistent: Header on all pages Sticky: Stays at top on scroll Responsive: Collapses to menu on mobile

Local Navigation

Sidebar: For app sections Tabs: For related content Breadcrumbs: For deep hierarchies

Contextual Navigation

Back Button: Return to previous page Related Links: Suggest next actions Quick Actions: Floating action button (mobile)


Error Handling Patterns

Form Errors

  • Inline error messages
  • Field-level validation
  • Summary at top (if multiple errors)

Transaction Errors

  • Clear error message
  • Suggested actions
  • Retry option
  • Support link

Network Errors

  • Retry button
  • Offline indicator
  • Cached data display

Success Patterns

Transaction Success

  • Success message
  • Transaction link
  • Next action CTA
  • Auto-dismiss toast

Form Success

  • Success state
  • Confirmation message
  • Redirect or next step

This flow document provides complete user journey maps and interaction patterns. Use these to ensure consistent UX across all applications.

CR8 Platform Documentation