Superprompt: Build Flutter Mobile App

Use with: Claude Code, Cursor, Gemini Code Assist

TASK: Create Flutter mobile app for AIVA merchant dashboard

CONTEXT:
Building an iOS/Android app for merchants to manage their store on the go.
The app connects to the AIVA Merchant Data API.

APP FEATURES:

- **Login Screen**

   - Input: API Key and Merchant ID
   - Store securely using flutter_secure_storage
   - Validate credentials on login

- **Dashboard Screen** (Home)

   - KPI cards: Revenue, MRR, Customers, Orders
   - Pull-to-refresh
   - Quick actions: Sync Subscriptions, View Customers

- **Customers Screen**

   - List view with segment badges
   - Search functionality
   - Filter by RFM segment
   - Tap to view customer details
   - Infinite scroll pagination

- **Customer Detail Screen**

   - Customer info card
   - Order history
   - Lifetime value
   - "Send Message" button (opens AIVA chat)

- **Subscriptions Screen**

   - MRR/ARR at top
   - List of active subscriptions
   - Status badges
   - Tap to see subscription details

- **Settings Screen**

   - API credentials (masked)
   - Logout button
   - Dark mode toggle
   - Notification preferences

TECHNICAL REQUIREMENTS:

- Flutter 3.16+

- Dart 3.2+

- State Management: Riverpod

- HTTP Client: Dio

- Secure Storage: flutter_secure_storage

- Charts: fl_chart

- Icons: flutter_icons

API INTEGRATION:

- Base URL: https://api.getaiva.ai

- Auth: X-API-Key header

- Error handling with retry logic

- Offline support with caching (Hive)

FOLDER STRUCTURE:
/lib
  /models           # Data models
  /providers        # Riverpod providers
  /screens          # Screen widgets
  /widgets          # Reusable widgets
  /services         # API service layer
  /utils            # Helper functions
  main.dart         # Entry point

UI/UX GUIDELINES:

- Material Design 3

- Purple/Pink color scheme (#8B5CF6, #EC4899)

- Dark mode support

- Smooth animations

- Loading skeletons

- Error states with retry

DELIVERABLES:

- Complete Flutter app with all screens

- API service layer with error handling

- Offline caching strategy

- Dark mode implementation

- README with build instructions

- Screenshots for app stores

START BUILDING NOW.
Create all screens, models, and services.
Make it production-ready for App Store/Play Store submission.
`"

**Expected Result:** A complete Flutter mobile app ready for app store submission. -