Roadmap.Honest & public.
origam is an early-stage Vue 3 design system. Here is where we stand today, what we have already shipped, and what is on the horizon.
WHERE WE STAND
Where 2.37.42stands.
An honest snapshot of what works, what is in progress, and what is still missing — every line below was measured, not transcribed.
Live today (11)
- Published on npm — origam 2.37.42, released automatically with sigstore provenance
- Full CI pipeline — 20 jobs across 5 workflows: lint, architecture guards, migration guard, type-check, unit tests, builds, i18n check, changelog drift check, e2e, marketing e2e, component a11y, marketing a11y and visual regression
- Documentation and stories deployed — the VitePress reference and the Histoire build both answer HTTP 200
- 7,192 unit tests green across 564 spec files — 77.8 % statement coverage, 79.9 % line coverage
- 256 Playwright spec files for 218 stories — every component family has an e2e guard
- 29 of 29 architecture guards passing, and 16 of 16 guard self-tests proving the detectors still measure
- Inspected on 1 September 2026: 216 components against 8 criteria — rendering, theme channel, reactivity, prop resolution, emits, semantics, story and doc sync, hardcoded strings: zero defect at that date
- SonarQube wired with unit-test coverage and a quality gate that blocks on security and critical issues
- Automated dependency updates — Dependabot opens grouped weekly pull requests for npm and GitHub Actions
- Monorepo in place — 5 pnpm workspace packages (ds, docs, marketing, stories, tests), the library still publishing from packages/ds
- Wave 4 shipped — 13 components + gradient support + OrigamTextMask (v2.6.0)
Not yet (3)
- Overlays still lack focus-trap assertions — one component out of the whole overlay family is covered, even though the per-component sweep now gates CI on an empty violation baseline
- Visual regression only started — the pinned-container suite covers a single component so far
- No bundle-size monitoring — no size budget is enforced on any sub-export
ALREADY SHIPPED
A full design system.Already in production.
origam is not starting from zero — here is the scope already shipped on npm, with the latest waves below.
- 96component families
- 139composables
- 6directives
- 218interactive stories
- 2base themes (light + dark)
- 3design-token tiers
Wave 1 — New components
- Tabs / Tab / TabPanel / TabPanels — 3 variants, 2 orientations, ARIA WAI-ARIA APG, lazy panel mount
- CommandPalette (⌘K) — fuzzy match, useHotkey cross-platform, reuses OrigamKbd
- SnackbarStack — 8 locations, FIFO max stack, useSnackbarStack singleton, role=status/alert per intent
- Bracket (tournament bracket) — 3 variants (single-elim, double-elim, round-robin), SVG connectors
Wave 2 — Enrichments
- OrigamParallax — multi-layer, direction, easing, CSS-first scroll-driven animation
- OrigamCode — Shiki syntax highlighting, 14 languages, 2 themes, line numbers, copy, filename
- OrigamTextareaField — rich mode contenteditable editor with 9 toolbar commands
- OrigamTextField — mask engine with 13 built-in patterns + Luhn + IBAN mod-97
Wave 3 — Infrastructure
- Official Nuxt module (sub-export origam/nuxt) — auto-import, SSR-safe theme plugin
- SSR safety audit + useCssSupportClient + OrigamClientOnly
- pnpm monorepo — 5 packages (ds, marketing, stories, docs, tests)
WHAT'S NEXT
A phased roadmap.
Each phase builds on the previous. The order reflects real technical dependencies, not arbitrary milestones. Open a phase to read every item in full.
Short term
Q3 20265 items
- Every e2e spec blocking in CI
Every component family already has Playwright coverage. Bring the whole suite into the blocking gate, wave by wave, fixing the instability instead of skipping it.
L - API audit before the module split
Sweep the public surface before packages/ds is split into modules: a full deprecation inventory, the missing @deprecated markers completed, and a codemod for the mechanical renames.
L - Overlay a11y audit
The per-component axe sweep gates CI on an empty violation baseline, so the automated pass is covered. What is missing is the overlay-specific contract: focus trap, focus restoration, aria-modal and Escape are asserted for Dialog, Select and the command palette — Menu, contextual menu, Tooltip, Drawer, Sheet and Snackbar have none.
M - SonarQube — clear the remaining debt
Unit-test coverage is wired into the scan and the quality gate is armed, blocking on security and critical issues. What remains is the verdict itself: an A rating on all four axes and zero open debt. Pull-request analysis stays out of scope while the server runs Community Edition, which analyses a single branch.
M - Bundle-size monitoring
No size budget is enforced today. Add size-limit on every sub-export with automatic pull-request comments, and set the threshold from a fresh measurement of the published tarball — 1 864 944 B when measured on 25 September 2026.
S
Mid term
Q4 2026 / Q1 202716 items
- v3.0.0 — Strategy B
Remove *Styles returns when the value is tokenised. Utility classes become the sole API. ~2× less reactive computation.
XL - Modular sub-exports (origam/core, origam/form, origam/chart, …)
Split the published library into tree-shakable sub-exports by domain, so an app only pays for what it actually imports. The existing origam barrel stays available for backward compatibility.
XL - accentColor rename (breaking v3)
bgColor → accentColor prop rename, aligned with the CSS accent-color standard. Full deprecation path included.
M - Semantic list variants (OrigamList)
OrigamList / OrigamListItem render div role="listbox" today. A new variant prop (unordered → ul/li, ordered → ol/li, nav, listbox) will emit real ul/ol/li semantics, replacing the boolean nav prop.
M - OrigamWizardForm — multi-step form
Composes the existing OrigamForm and OrigamStepper — no reimplementation of validation or step navigation. Per-step validation blocks progression until the active step is valid; a single v-model aggregates every step's values.
M - OrigamPage — page wrapper
A deliberately simple structural wrapper with three optional zones — header, content, footer — rendered as real semantic elements. No imposed scroll or sticky behaviour, just a consistent page skeleton on top of the DS spacing tokens.
S - OrigamSection — section schemas
OrigamSection was removed from the repository on 2026-08-26 — it was an empty 14-line shell with no shipped value. This milestone creates it from scratch: predefined section schemas such as hero, split, centered or full-bleed, as overridable prop presets on a real section element, props-first.
M - Motion & a11y media tokens
tokens/semantic/motion.json — durations, easings. Auto 0ms if prefers-reduced-motion. High-contrast ramp.
M - v-background directive
Compose one or several backgrounds on any element — image or color gradient (tokenised intents + custom). Per-layer position, size, repeat and a simple mask. Each layer renders as a pseudo-element (default, zero extra DOM) or an injected div, switchable in the directive config.
L - TextMask — colored stroke & fill
Extend OrigamTextMask with an outlined mode: transparent text with a colored per-letter stroke (-webkit-text-stroke) and/or a distinct fill, for outline-only and contrasted headline effects. Stays real, selectable text; CSS-first with a solid fallback.
M - Complete the /theming builder
The marketing theme builder shipped as a partial V1 (~14 core components, tokens capped, modals/slot-driven not previewable). Finish it: cover all editable components, handle overlay/slot-driven previews, lift the token cap, and rework the UI — the current ergonomics are clearly not good enough. Stays data-driven and DS-first.
L - Visual regression testing
Playwright toHaveScreenshot() per Variant, or Chromatic / Lost-Pixel. Baseline on main, diff blocks PR.
M - Turborepo build cache
Replace raw pnpm -r scripts with Turborepo pipelines. Remote cache drastically cuts CI rebuild time.
S - variant as a preset of real props
Turn each visual variant into a transparent, fully overridable preset of component props instead of hardcoded styling — piloted on OrigamBlockquote, then generalized.
L - OrigamAddMore — form field repeater
A new form component for repeating a group of fields with an 'Add more' action, min/max bounds, and full keyboard and screen-reader support.
M - OrigamBtn — contentJustify prop
A props-first way to control how a button's content aligns inside its layout, for buttons that don't rely on the prepend/append icon slots.
S
Long term
> 6 MONTHS8 items
- Vue Vapor mode (exploratory)
No-virtual-DOM compilation — ~40 % less runtime overhead. POC on 5 pivot components, benchmarks first.
XL - Web Components export
origam/elements sub-export via defineCustomElement. Cross-framework demo (React, Svelte, Angular).
L - Theme Builder UI
Standalone app consuming origam itself: edit primitive tokens, preview components in real time, export brand JSON.
XL - Marketing — database + auto DS sync
Persist the whole reference catalogue (components, composables, types, enums, interfaces, utils, consts) in a database (Nitro + TypeORM / PostgreSQL) instead of static glob files. A sync job reads the DS source and upserts the DB on every release, so the reference docs follow the design system automatically. Editorial content lives in the same tables with a DS-auto vs edited flag.
XL - Marketing — admin backend (CMS)
A back-office to manage all site content when auto-generation falls short: edit any page (reference + editorial), reorder, publish/hide, without touching code. Fully translatable (DB-driven i18n, per-locale completeness) and built with origam itself — a full-scale DS showcase. Auth + roles, change audit, pre-publish guardrail. Stack: Nitro + TypeORM/PostgreSQL + Redis.
XL - Vue Server Components
Track the Vue compiler ecosystem and align with a React-Server-Components-style pattern once it stabilizes.
M - AI-assisted generation (Figma → code)
Make the Figma plugin bidirectional — turning Figma designs into origam components automatically speeds up new component creation.
L - Maintenance & EOL policy
A documented LTS policy: after v3.0 ships, the v2.x branch keeps receiving security and critical bugfixes for a defined window.
Continuous hygiene
EVERY SPRINT8 items
- Dependency hygiene
Weekly automated dependency updates; zero high or critical vulnerability tolerated at merge time.
- Documentation coverage
No component merges without its doc page. Quarterly audit of the documentation links.
- Performance budget
Bundle-size checks block any PR that exceeds its budget; every changed component is profiled before merge.
- Boy-scout refactors
Any PR touching a component with legacy patterns (hardcoded colors, inline-only styling) migrates it before merge.
- Code-quality gate
Static analysis, strict linting, and type-checking run on every PR — no unexplained escape hatches.
- Changelog discipline
The changelog is updated with every pull request, not just at release time.
- Test-as-you-build
Every new story ships with its end-to-end coverage in the same pull request — checked automatically in CI.
- Security checks on every PR
Secret scanning on every pull request, plus a dedicated security review for any change to server code, services, or build configuration.
THE WHOLE CATALOGUE IS SHIPPED
223 componentsalready shipped.
Every component in origam is published on npm and usable today — there is no waiting list. What is left to build is above, in the roadmap phases.
Data Display
55- Avatar
- AvatarGroup
- Badge
- Bracket
- BracketCompetitor
- BracketMatch
- BracketRound
- Calendar
- Carousel
- CarouselItem
- ChartBullet
- ChartHeatmap
- ChartHoneycomb
- ChartLegend
- ChartMap
- ChartPareto
- ChartPictorial
- ChartPolar
- ChartPolarBar
- Chip
- ChipGroup
- Code
- CodeGroup
- Counter
- DataList
- DataTable
- DataTableColumnCell
- DataTableFooter
- DataTableHeaderCell
- DataTableHeaders
- DataTableHeadersCell
- DataTableRow
- DataTableRows
- DataText
- DataTitle
- Img
- InfiniteScroll
- InfiniteScrollIntersect
- LigatureIcon
- List
- ListGroup
- ListGroupActivator
- ListItem
- ListSubheader
- NumberFormat
- QrCode
- Table
- TextMask
- Timeline
- TimelineItem
- Title
- Treeview
- TreeviewNode
- VirtualScroll
- VirtualScrollItem
Data Visualization
17Feedback & Status
12Form & Input
47- Btn
- BtnGroup
- BtnToggle
- Checkbox
- CheckboxBtn
- CheckboxGroup
- ColorPicker
- ColorPickerCanvas
- ColorPickerEdit
- ColorPickerField
- ColorPickerPreview
- ColorPickerSwatches
- ConfirmWrapper
- DatePicker
- DatePickerControls
- DatePickerField
- DatePickerHeader
- DatePickerMonth
- DatePickerMonths
- DatePickerYears
- Field
- FileField
- FileFieldDragNDropItem
- FileFieldListItem
- Form
- InlineEdit
- Input
- Messages
- NumberField
- OtpInputField
- PasswordField
- Radio
- RadioBtn
- RadioGroup
- RatingField
- RatingFieldItem
- RichToolbar
- Select
- SelectionControl
- SelectionControlGroup
- SliderField
- SliderFieldTrack
- Switch
- SwitchTrack
- TextareaField
- TextareaFieldRichToolbar
- TextField
Layout & Structure
28Media
16Navigation
14Overlay & Surface
8Surface
3Typography
2Utilities & Providers
21
Follow the progress.
Star the repository on GitHub to stay updated. Contributions and feedback are welcome.