GenUI Touch
Make generated UI your own.
GenUI generates interfaces dynamically. GenUI Touch lets developers and users adjust the appearance of those interfaces in the running application, without changing source code or editing A2UI JSON.
Open GenUI Touch over the live UI. Triple-click a widget on desktop or long-press it on touch devices to select it, then edit the properties the host application has made available. Changes appear immediately; undo, redo, discard, and save are supported. Manual editing does not require an AI service.
Select a widget in the running app or component tree, then adjust its properties alongside a preview.
Where it can help
- Developer: inspect and tune generated widgets in their real application context, without rebuilding or making another AI call for every visual change.
- Designer: refine typography, spacing, images, and other available visual properties directly on a working interface.
- Multi-tenant app administrator: adjust catalog widget defaults for a company or team, with the scope and permissions managed by the host app.
- End user: personalize selected parts of their own interface, manually or with optional AI assistance.
Unlike a theme setting, GenUI Touch can edit individual rendered widgets as well as defaults for catalog widget types. It does not replace an application's theme or design system.
Two editing modes
| Surface | Gallery |
|---|---|
| Customize a specific widget in the current generated UI. | Customize default property values for a widget type. |
| Select it by triple-click, long-press, or from the component tree. | Select a catalog widget and edit its preview. |
GenUI Touch is a movable, resizable panel inside the running app. Changes are previewed as you make them. With host-provided storage and stable presentation roles, saved appearance settings can be reapplied to later generated content.
The compact GenUI Touch window keeps the property editor and preview visible. Select another widget in the app without closing GenUI Touch; edits to a shared template appear on every instance.
Example
Try the live Restaurant Finder demo or follow the example customization walkthrough. It uses recorded agent responses by default, so you can select, edit, save, and restore customizations without configuring an AI service.
The repository also includes Simple Chat with GenUI Touch, adapted from Flutter's official GenUI example, with a recorded demo and optional live Gemini chat. Its migration log documents integration decisions and limitations.
Optional AI integration can provide scoped property editing or propose new generated surfaces. Human edits and AI generation can be combined, subject to the host application's integration.
Work with complex layouts, adjust individual widgets, or describe a new presentation and generate an AI proposal using the host application's AI integration.
Integration
- Register permitted visual properties using
EditableCatalogRegistry. - Attach
GenUiCustomizerand decorate catalog items withdecorateEditableCatalogItem. - Open
showEditableGenUiStudio; optionally provideEditableGenUiStorageandEditableGenUiComposer. - Store
GenUiAppearanceProfilevalues and apply them to incomingupdateComponentsmessages using stable presentation roles.
Only host-approved properties are editable. Data bindings, actions, and component relationships remain protected. The host controls authorization, storage, and the scope of saved preferences.
See the installation and integration guide for the complete example file map and the changes needed in another host application.
For AI coding agents integrating the package into an existing Flutter GenUI app, use the genui-customizer-integration Dart Package Skill. It covers editable catalogs, selection gestures, local property editing, persistence, and replaying saved appearance after AI regeneration.
For local development, the repository pins Flutter 3.47.9 in .fvmrc (fvm use).
License
GenUI Touch is licensed under the PolyForm Perimeter License 1.0.1. The adapted Restaurant Finder example retains its upstream notices and license; see UPSTREAM_LICENSE.
Project status
Experimental. APIs and behavior may change without backward compatibility. This project is developed with heavy use of AI, including AI-assisted coding; its implementation should be reviewed and tested accordingly.
GenUI Touch focuses on runtime visual customization. It is not a design-time UI builder or a replacement for Flutter development tools. Feedback and contributions are welcome.
Libraries
- genui_customizer
- Public API for runtime editing and previewing host-approved GenUI properties.