Flutter SDK

flutter pub add morphui

import 'package:flutter/material.dart';
import 'package:morphui/morphui.dart';

void main() {
  runApp(
    MorphProvider(
      licenseKey: 'morph-free-demo',
      baseTheme: ThemeData.light(),
      child: const MyApp(),
    ),
  );
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    final adapted = context.maybeMorph?.adaptedTheme;
    return MaterialApp(
      theme: ThemeData.light(),
      darkTheme: adapted ?? ThemeData.dark(),
      themeMode: ThemeMode.system,
      home: const HomeScreen(),
    );
  }
}

dependencies:
  flutter:
    sdk: flutter
  morphui: ^0.1.2

flutter pub get

MorphProvider(
  licenseKey: 'morph-pro-xxxxxxxx',

  // Theme pass either a ThemeData (CAS 1) or a MorphColors palette (CAS 2),
  // or both (CAS 3). Backend Claude generates the dark variant.
  baseTheme: AppTheme.lightTheme,
  colors: const MorphColors(
    background: Colors.white,
    primary: Color(0xFF4F46E5),
    surface: Colors.white,
    text: Color(0xFF0F172A),
    error: Color(0xFFDC2626),
    success: Color(0xFF10B981),
    warning: Color(0xFFF59E0B),
  ),

  // Curated feature presets  see the "Curated presets" callout below.
  features: MorphFeatures.fintech(),

  // Anonymous analytics disabled by default; consent-gated when on.
  analytics: MorphAnalyticsConfig(
    enabled: true,
    userConsent: _userHasConsented,
    uploadInterval: const Duration(hours: 24),
  ),

  // Suggestion-engine hooks called when the user accepts a suggestion.
  onDarkModeRequested: (ctx) => themeController.setDark(),
  onResumePosition: (route, depth) => scrollController.jumpToPercent(depth),

  child: const MyApp(),
)

final adapted = context.maybeMorph?.adaptedTheme;

return MaterialApp(
  theme: AppTheme.lightTheme,
  darkTheme: adapted ?? AppTheme.darkTheme, // null until first generate
  themeMode: ThemeMode.system,
  home: const HomeScreen(),
);

import 'package:flutter/material.dart';
import 'package:morphui/morphui.dart';

class AppColors {
  // Const fallbacks used in theme definitions, BorderSide, etc.
  static const Color background = Color(0xFFF5F7FA);
  static const Color primary = Color(0xFF4F46E5);
  static const Color text = Color(0xFF0E121B);

  // Adaptive accessors read inside widgets, follow Morph's adaptation.
  static Color backgroundOf(BuildContext ctx) =>
      ctx.morphPalette?.background ?? background;

  static Color primaryOf(BuildContext ctx) =>
      ctx.morphPalette?.primary ?? primary;

  static Color textOf(BuildContext ctx) =>
      ctx.morphPalette?.text ?? text;
}

// Static never adapts (use in const widgets, theme definitions)
const Scaffold(backgroundColor: AppColors.background)

// Adaptive follows Morph in dark mode
Scaffold(backgroundColor: AppColors.backgroundOf(context))

class AppColorsNeutral {
  static const Color s25 = Color(0xFFFFFFFF);
  static const Color s50 = Color(0xFFF5F7FA);
  // ... s100..s900 ...
  static const Color s950 = Color(0xFF0E121B);

  static const _stops = MorphPaletteStops(
    s25: s25, s50: s50, s100: s100, s200: s200, s300: s300, s400: s400,
    s500: s500, s600: s600, s700: s700, s800: s800, s900: s900, s950: s950,
  );

  /// Adaptive accessor - mirrored stops in dark mode.
  static MorphPaletteStops of(BuildContext ctx) => _stops.adapt(ctx);
}

// Usage:
Container(color: AppColorsNeutral.of(context).s50)
// Light mode → #F5F7FA, dark mode → #181B25 (= original s900)

// GoRouter
GoRouter(
  observers: [MorphNavigatorObserver.instance],
  routes: [
    GoRoute(path: '/home', builder: (_, __) => const HomeScreen()),
    GoRoute(path: '/profile', builder: (_, __) => const ProfileScreen()),
  ],
)

// Vanilla MaterialApp
MaterialApp(
  navigatorObservers: [MorphNavigatorObserver.instance],
  routes: { '/home': (_) => const HomeScreen() },
)

MorphReorderableColumn(
  zones: [
    MorphZone(id: 'search', priority: 1, child: SearchSection()),
    MorphZone(id: 'feed', priority: 2, child: FeedSection()),
    MorphZone(id: 'trending', priority: 3, child: TrendingSection()),
  ],
)

MaterialApp(
  builder: (context, child) => MorphSuggestionOverlay(
    child: child ?? const SizedBox.shrink(),
  ),
  home: const HomeScreen(),
)

// Stakes-sensitive - confirm before applying
context.morphSetTransferContext(
  amount: '50.00',
  recipient: 'Alice',
  step: 1,
  // strategy defaults to confirm - explicit here for readability
);

// Low-stakes - restore silently on resume
context.morphSetCheckoutContext(
  cartData: {'total': cart.total},
  scrollDepth: scrollPct,
  strategy: RecoveryStrategy.auto,
);

// On every step, declare the snapshot with workflow metadata
context.morphSetKycContext(
  step: currentStep,
  totalSteps: 7,
  savedData: {'idType': 'passport', 'fullName': name},
  workflowId: 'kyc-2026-04-26-abc123',
  workflowStep: currentStep,
);

// On resume, read the chain from the recovery engine
final recovery = context.morphRecovery; // null when feature is off
final chain = recovery?.pendingChain ?? const [];
for (final snap in chain) {
  // Rehydrate your state per step
  controller.applySnapshot(snap);
}

// Use the default - 30 min for checkout
context.morphSetCheckoutContext(cartData: {...});

// Override - high-stakes payment, 90 second window
context.morphSetTransferContext(
  amount: '5000.00',
  recipient: 'Vendor',
  ttl: const Duration(seconds: 90),
);

// Wire the outcome from your suggestion overlay
final recovery = context.morphRecovery;

await recovery?.recordOutcome(
  bucket: snapshot.metadata['pauseBucket'] == 'real'
      ? InterruptionBucket.real
      : InterruptionBucket.quick,
  outcome: userTappedResume
      ? RecoveryOutcome.accepted
      : userTappedDismiss
          ? RecoveryOutcome.rejected
          : RecoveryOutcome.ignored,
);

Scaffold(
  body: GripAdaptiveLayout(
    child: ProductDetails(),
    primaryAction: FilledButton.icon(
      onPressed: _addToCart,
      icon: const Icon(Icons.shopping_cart),
      label: const Text('Add to Cart'),
    ),
    defaultAlignment: Alignment.bottomRight,
    transitionDuration: const Duration(milliseconds: 300), // 0.1.2 - tunable
    transitionCurve: Curves.easeOutCubic,
  ),
)

FatigueAdaptiveForm(
  // 0.1.2 default - interpolates scale 1.0 → 1.30 continuously,
  // banner fades in past score 40, simplified set kicks in past 70.
  adaptation: FatigueAdaptation.smooth,

  normalFields: [
    AmountField(),
    RecipientField(),
    DescriptionField(),
    DateField(),
    CategoryField(),
  ],
  simplifiedFields: [
    AmountField(),
    RecipientField(),
  ],
  submitButton: TransferButton(),
)

final fatigue = MorphInheritedWidget.maybeOf(context)?.fatigueDetector;

// Wrong-zone tap (5% weight)
fatigue?.recordTapError();

// Backspace + retype on a field (5% weight)
fatigue?.recordTypingError();

// Back-then-forward in 3 seconds (15% weight - strong signal)
fatigue?.recordNavigationError();

// 1. Swap entire widget trees per mode
BatteryAwareWidget(
  normal: FullDashboard(),
  medium: SimplifiedDashboard(),
  low: EssentialDashboard(),
  critical: TextOnlyDashboard(),
)

// 2. Adapt the active ThemeData (near-black on critical → OLED savings)
MaterialApp(
  builder: (ctx, child) => BatteryAwareTheme(
    adaptiveMode: BatteryAdaptiveMode.suggestion, // 0.1.2 - wait for opt-in
    isOLED: null, // null = auto-detect; pass true/false for manual override
    child: child ?? const SizedBox.shrink(),
  ),
)

MorphProvider(
  features: const MorphFeatures(
    batteryAware: true,
    chargePatternPrediction: true, // off by default
  ),
  child: const MyApp(),
)

// In your existing GPS subscription:
geolocator.getPositionStream().listen((pos) {
  MorphInheritedWidget.maybeOf(ctx)?.gpsAdapter
    ?.onLocationUpdate(
      speedKmh: pos.speed * 3.6,
      accuracy: pos.accuracy,
    );
});

// On any screen - text scales + contrast boosts when moving
GpsAdaptiveScaffold(body: DashboardContent())

MorphProvider(
  analytics: MorphAnalyticsConfig(
    enabled: true,
    userConsent: _hasUserConsent,
    onConsentRequired: () => showConsentDialog(context),
    uploadInterval: const Duration(hours: 24),
    minInteractions: 20, // skip noisy zero-data uploads
    retentionDays: 30,    // hard-capped at 30
  ),
  ...
)

final plan = context.morphPlan;
// MorphPlan: free | professional | business | enterprise

if (context.isMorphAgency) {
  // Equivalent to plan.isBusiness  true on Business + Enterprise.
  // (The shorthand keeps its legacy name; isMorphBusiness lands in v0.4.)
  // Show the AI insights tab.
}

// Imperative gate silently no-ops if the plan is too low.
// Wire onDenied: to your own upsell UI on YOUR admin surfaces.
context.requireMorphPro(() {
  Navigator.push(context, MaterialPageRoute(
    builder: (_) => const AdvancedSettings(),
  ));
});

class AppTheme {
  static final lightTheme = ThemeData(/* ... */);
  static final darkTheme  = ThemeData(/* ... */); // hand-tuned, keep it
}

void main() {
  runApp(
    MorphProvider(
      licenseKey: 'morph-free-demo',
      baseTheme: AppTheme.lightTheme, // Morph reads this to generate dark
      child: const MyApp(),
    ),
  );
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    final adapted = context.maybeMorph?.adaptedTheme;

    return MaterialApp(
      theme: AppTheme.lightTheme,
      darkTheme: adapted ?? AppTheme.darkTheme, // safe fallback
      themeMode: ThemeMode.system,
      home: const HomeScreen(),
    );
  }
}

final state          = context.morph;            // throws if no provider
final maybeState     = context.maybeMorph;       // null-safe variant

// Theme + appearance
final theme          = context.morphTheme;
final isDark         = context.isMorphDark;
final isHighContrast = context.isHighContrast;
final settings       = context.systemSettings;
final adapted        = context.adaptedTheme;     // ThemeData? - plug into MaterialApp
final palette        = context.morphPalette;     // MorphAdaptedColors?

// Behavioural
final scaled         = context.isFontScaleApplied;
final order          = context.zoneOrder;
final db             = context.morphDB;
final reorder        = context.morphReorder;
final navObserver    = context.morphNavigatorObserver;

// Analytics config (raw)
final analyticsCfg   = context.morphAnalyticsConfig;

// E-commerce
context.morphSetCheckoutContext(
  cartData: { 'total': cart.total, 'items': cart.itemCount },
  scrollDepth: scrollPosition,
);

context.morphSetProductContext(
  productName: product.name,
  productId: product.id,
  scrollDepth: scrollPosition,
);

// Fintech
context.morphSetTransferContext(
  amount: '50.00',
  recipient: 'Alice',
  step: 1,
);

context.morphSetKycContext(
  step: 2,
  totalSteps: 3,
  savedData: { 'documentType': 'id_card' },
);

final enabled    = context.morphAnalyticsEnabled;  // dev opted in?
final consented  = context.morphUserConsented;     // user consented?
final sizeKb     = await context.morphStorageSize; // approx KB on disk

// GDPR-style erase - drops every row across every behavioural box.
await context.clearMorphData();

final plan     = context.morphPlan;          // MorphPlan enum
final features = context.morphPlanFeatures;  // capability matrix

// Boolean shortcuts (legacy names  kept for backward compat).
// isMorphPro    → true on Professional, Business, Enterprise
// isMorphAgency → true on Business, Enterprise
if (context.isMorphAgency) {
  // Show the AI insights tab
}

// Imperative gates silently no-op if the plan is too low.
context.requireMorphPro(
  () => Navigator.push(context, route),
  onDenied: () => showSnackBar('Available on Professional'),
);

context.requireMorphAgency(
  () => openAnalyticsScreen(),
  onDenied: () => showSnackBar('Available on Business'),
);

final brand = context.morphExt?.brandAccent
            ?? Theme.of(context).colorScheme.primary;