v2.37.42 — Wave 4 shipped

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.

Measured against the repository on 25 September 2026

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.

Counted from the repository source tree on 25 September 2026
  • 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 2026
5 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 2027
16 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 MONTHS
8 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 SPRINT
8 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.

223 components in 11 categories, read live from the catalogue

Follow the progress.

Star the repository on GitHub to stay updated. Contributions and feedback are welcome.