Theme it your way
The live demo on the home page is one build of aleup's document workbench — editor, format-routed preview, cloud import picker, PDF export. This page is the same workbench wearing different design systems. Switch the tab and the UI layer changes completely while the underlying aleup hooks stay byte-for-byte identical — that's the whole point of the theming contract.
Tailwind v4 + Radix + cva — the flagship reference.
Everything above is driven by the exact same useUppyImport, useCloudDrivePicker,
useDocToolbarState, and <DocumentViewer> calls — only the buttons, dialogs, and
tokens differ. Pick the library you already use (or bring your own); see
Theming for the four layers (slots, classNames, data-aleup-*
attributes, --aleup-* variables).
Each demo mocks the server side: the DestinationPort points at a no-op target and the
cloud picker browses a fake provider (nested folders, pagination, a non-selectable
video, a Google Doc) so you can exercise the full connect → browse → select → expand
flow without a Companion server. @aleup/docx (the ~16 MB
DOCX WASM runtime) is intentionally left out of the demos.
What each demo shows
- Editor —
<DocEditor>seeded with a legal MSA, driven by a toolbar built in that design system onuseDocToolbarState. - Preview —
<DocumentViewer>routing markdown, plain text, an image, and an unknown type (which hits the themedfallbackslot). - Cloud picker — a dialog over
useCloudDrivePicker, exercising pagination and breadth-first folder expansion into a flat file list. - Export PDF —
downloadElementAsPdfover the live editor page. - The daisyUI demo adds a live theme switcher that rethemes the aleup document page
through
--aleup-*CSS variables.
Available examples
| Example | Design system | Status |
|---|---|---|
examples/shadcn | shadcn/ui-style (Tailwind v4 + Radix + cva) — flagship reference | ✅ Tier 1 |
examples/mui | MUI (Material UI) | ✅ Tier 1 |
examples/daisyui | daisyUI 5 | ✅ Tier 1 |
examples/mantine | Mantine | planned |
examples/heroui | HeroUI | planned |
examples/headlessui | Headless UI | planned |
examples/magicui | Magic UI (shadcn-based) | planned |
examples/aceternity | Aceternity UI (shadcn-based) | planned |
Run one locally
pnpm install
pnpm build # build the packages first
pnpm --filter aleup-example-shadcn dev
The built examples deploy with this site under /demos/*, so the embeds above are the
exact same apps you'd run locally.