Skip to main content

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.

Open full screen ↗

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).

These run with zero backend

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 on useDocToolbarState.
  • Preview<DocumentViewer> routing markdown, plain text, an image, and an unknown type (which hits the themed fallback slot).
  • Cloud picker — a dialog over useCloudDrivePicker, exercising pagination and breadth-first folder expansion into a flat file list.
  • Export PDFdownloadElementAsPdf over the live editor page.
  • The daisyUI demo adds a live theme switcher that rethemes the aleup document page through --aleup-* CSS variables.

Available examples

ExampleDesign systemStatus
examples/shadcnshadcn/ui-style (Tailwind v4 + Radix + cva) — flagship reference✅ Tier 1
examples/muiMUI (Material UI)✅ Tier 1
examples/daisyuidaisyUI 5✅ Tier 1
examples/mantineMantineplanned
examples/herouiHeroUIplanned
examples/headlessuiHeadless UIplanned
examples/magicuiMagic UI (shadcn-based)planned
examples/aceternityAceternity 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.