Complete guide to the aiui.template.yaml configuration schema.
aiui.template.yaml
PraisonAIUI uses a single YAML file to configure your entire site. This file defines:
Always specify the schema version:
> Note: The ui field is a theming hint. Components are UI-agnostic and use CSS classes you can style with any framework.
ui
Auto-install shadcn components at build time:
When you run aiui build, any missing components are automatically installed via npx shadcn add.
aiui build
npx shadcn add
Define reusable components:
| Type | Description |
|------|-------------|
| Header | Site header with logo, nav, CTA |
Header
| Footer | Site footer |
Footer
| DocsSidebar | Documentation sidebar navigation |
DocsSidebar
| Toc | Table of contents |
Toc
| DocContent | Rendered markdown content |
DocContent
Templates combine a layout with slot assignments:
| Layout | Description |
|--------|-------------|
| ThreeColumnLayout | Sidebar + Content + TOC |
ThreeColumnLayout
| TwoColumnLayout | Sidebar + Content |
TwoColumnLayout
| CenteredLayout | Centered content, no sidebar |
CenteredLayout
| FullWidthLayout | Full width content |
FullWidthLayout
| FlexibleLayout | WordPress-style widget zones |
FlexibleLayout
Place widgets in layout zones without modifying markdown:
| Zone | Description |
| header | Top header |
header
| topNav | Below header nav |
topNav
| hero | Hero banners |
hero
| leftSidebar | Left column |
leftSidebar
| main | Main content |
main
| rightSidebar | Right column |
rightSidebar
| bottomNav | Pagination area |
bottomNav
| footer | Footer widgets |
footer
| Widget | Description |
| StatsCard | Metrics display |
StatsCard
| QuickLinks | Navigation links |
QuickLinks
| Newsletter | Email signup |
Newsletter
| HeroBanner | Hero section |
HeroBanner
| SocialLinks | Social icons |
SocialLinks
| Copyright | Copyright text |
Copyright
See Widget Zones for full documentation.
Map URL patterns to templates:
Route matching uses glob patterns:
*
**