What is in the Basic Catalog
The components are Text, Image, Icon, Video, AudioPlayer, Row, Column, List, Card, Tabs, Modal, Divider, Button, TextField, CheckBox, ChoicePicker, Slider, DateTimeInput. The functions are required, regex, length, numeric, email, formatString, formatNumber, formatCurrency, formatDate, pluralize, openUrl, and, or, not. Both lists are read from the Basic Catalog file in the v1.0 specification.
What you can do with it
- Show content: Text, Image, Icon, Video and AudioPlayer.
- Arrange content: Row, Column, List, Card, Tabs, Modal and Divider. Row, Column and List can repeat their children from a data list.
- Take and check input: Button, TextField, CheckBox, ChoicePicker, Slider and DateTimeInput, all of which accept validation checks.
- Bind to live data: any property typed as a dynamic value can take a data binding or a function call.
- React to the user: a Button fires an action to the agent.
- Compute and format: the functions:
and,or,not;formatCurrency,formatDate,formatNumber,formatString,pluralize;email,length,numeric,regex,required; andopenUrl.
Try it live
The Demo Gallery runs every component and function from a real A2UI message in your browser. Click a button, type in a field, and see what the agent would receive.
How far can Basic go?
It goes further than the name suggests, and it has clear limits. Our article A2UI: How basic is the basic catalog? measures how far, with the message sizes for the same game built four ways. A drawn Image can show a chart, a board or a simple animation, but it is a picture: no hover, no zoom and no partial updates. For those you need a custom catalog. How to make an A2UI custom catalog walks through making one, and the worked example shows ours.
FAQ
What is the A2UI Basic Catalog?
It is the standard catalog of components and functions that A2UI defines, so any renderer that supports it can draw any surface built from it with no custom code. It has 18 components and 14 functions in v1.0.
What components does the Basic Catalog have?
Text, Image, Icon, Video, AudioPlayer, Row, Column, List, Card, Tabs, Modal, Divider, Button, TextField, CheckBox, ChoicePicker, Slider, DateTimeInput.
What functions does the Basic Catalog have?
required, regex, length, numeric, email, formatString, formatNumber, formatCurrency, formatDate, pluralize, openUrl, and, or, not. They format values for display, check input and combine conditions, and openUrl opens a link.
Can you draw charts with only the Basic Catalog?
Not with a component: there is no chart in it. In our tests, a picture drawn on the server and shown in a Basic Image worked as a static picture or a simple animation on the official React renderer and in one Gemini Enterprise trial app (v0.9 dialect, one run). We have not tested it on native renderers such as Flutter or Jetpack Compose.
Do I need a custom catalog?
Only when a picture is not enough, for example when you need hover, zoom, partial updates or a component with real keyboard behaviour. See how to make a custom catalog.
Get started
- The Basic Catalog in the official docs: Catalogs on a2ui.org.
- Our measurements: A2UI: How basic is the basic catalog?.
- New to the protocol? Start with What is A2UI?.