intyx_dynamic_widget #

AI-driven, JSON-configured dynamic widget system for Flutter. An AI agent decides which widget to show and with which parameters — your app just renders the result.

Features #

Installation #

dependencies:
  intyx_dynamic_widget: ^0.1.1

flutter pub get

Quick Start #

1. Register built-in widget types (once at app start) #

import 'package:intyx_dynamic_widget/intyx_dynamic_widget.dart';

void main() {
  registerDefaultWidgets();
  runApp(const MyApp());
}

2. Initialize the SDK #

await IntyxDynamicWidget.init(
  apiKey: 'intyx_pro_xxxxxxxxxxxxxxxx',  // from intyx.dev/dashboard
);

3. Render widgets from an AI agent response #

DynamicWidgetContainer(
  responseJson: agentResponse,           // Map<String, dynamic> from your backend
  colorScheme: Theme.of(context).colorScheme,
  padding: const EdgeInsets.all(12),
  onDismiss: (widgetId) => print('dismissed: $widgetId'),
  onAction: (widgetId, action) => handleAction(action),
)

4. Fetch widgets via the service #

final service = WidgetService(baseUrl: 'https://your-backend.com');
final response = await service.resolveAgentTask(
  taskId: 'task_abc123',
  context: {
    'weather': 'sunny',
    'user_preferences': userPrefs,
    'current_date': DateTime.now().toIso8601String(),
  },
);

Widget Types #

UI Cards #

Category Widgets #

Custom Widget Types #

// Register a custom type alongside the built-ins
WidgetRegistry.register('my_custom_type', (params) {
  return MyCustomWidget(
    title: params['title'] as String,
    color: Color(int.parse(params['color'] as String)),
  );
});

JSON Response Format #

{
  "widgets": [
    {
      "id": "w_abc123",
      "type": "banner",
      "params": {
        "emoji": "☀️",
        "text": "Good morning! Flash sale ends tonight."
      },
      "common": {
        "priority": 1,
        "dismissible": true,
        "ttl_seconds": 3600
      }
    }
  ]
}

Backend #

The SDK is designed to work with the Intyx backend — a Python/Flask API with Gemini AI integration. You can also bring your own backend as long as it returns the JSON format above.

Get an API key at intyx.dev.

License #

MIT — see LICENSE for details.