> ## Documentation Index
> Fetch the complete documentation index at: https://docs.presentum.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Presentum Documentation
> A declarative Flutter engine for building dynamic, conditional UI at scale
## Build dynamic UI at scale
Presentum is a declarative Flutter engine that helps you manage campaigns, app updates, special offers, tips, and notifications with clean, testable, type-safe code.
Show the right message to the right user at the right time, with impression limits, cooldowns, A/B testing, and analytics - all handled automatically.
Describe presentations as data. No imperative show/hide logic.
Generics ensure compile-time correctness. No runtime surprises.
Business logic in guards, UI in outlets, tracking in storage.
Eligibility rules, A/B tests, cooldowns, impression tracking built-in.
## Quick example
```dart theme={null}
// 1. Define surfaces
enum AppSurface with PresentumSurface {
homeTopBanner,
popup;
}
// 2. Create payload
class CampaignPayload extends PresentumPayload {
final String id;
final int priority;
final Map metadata;
final List options;
}
// 3. Initialize
final presentum = Presentum(
storage: MyStorage(),
guards: [CampaignGuard()],
);
// 4. Render
PresentumOutlet(
surface: AppSurface.homeTopBanner,
builder: (context, item) => BannerWidget(item),
)
```
That's it! Presentum handles eligibility, impressions, cooldowns, and state
automatically.
## Get started
Learn what Presentum is and why it exists
Build your first presentation in 5 minutes
Deep dive into architecture
## What you can build
Check out the [comprehensive example application](https://github.com/itsezlife/presentum/tree/master/example) source code.
Maintenance mode dialogs and system status notifications
Force update dialogs, optional upgrade prompts, changelog announcements
Special offers with discount codes, limited-time sales, seasonal campaigns,
A/B tests
User-configurable feature flags, toggleable from settings, with dependency
chains and feature-aware widgets that adapt UI based on enabled features
Settings, user preferences, and feature toggles
## Guides
Build eligibility logic
{" "}
Persistent tracking layer
{" "}
Create presentation widgets
{" "}
Integrate with your state solution
## Recipes
Dynamic campaign management
{" "}
Force and optional updates
{" "}
Multi-variant experiments
Track impressions and conversions
## Community
Source code and issues
Package page and API docs
## Ready to start?
Build your first Presentum presentation in 5 minutes