Skip to content

v0.3.0

Choose a tag to compare

@barmoshe barmoshe released this 23 Jun 13:41
· 28 commits to main since this release

MDP 0.3.0 — interactive forms, custom brand color, an MCP server, a live site, and the first npm publish.

Highlights

  • Interactive forms. Four new artifacts that compile the same source into client-side experiences: scroll (scroll-driven narrative with reveal-on-enter, a progress bar, and a dot rail), accordion (collapsible <details> sections with Expand/Collapse all), tabs (arrow-key navigation and a deep-linkable hash), and stepper (a guided walkthrough with Back/Next). Each is opt-in via forms:, degrades to readable HTML with no JavaScript, respects prefers-reduced-motion, and keeps WCAG-AA contrast and keyboard navigation.
  • Timeline, FAQ, and pricing blocks (mdp:timeline, mdp:faq, mdp:pricing), rendered across every form.
  • Custom brand color. A brand-accent frontmatter field (one hex) that the engine derives a full WCAG-AA accent set from (five roles, light and dark), falling back to the named theme when a color cannot be made accessible. An optional brand-accent-2 adds a secondary color used sparingly, and brand-font selects the body/UI family from a closed set of system stacks.
  • Five more themes (ocean, forest, terracotta, coral, plum) for eleven total, each AA-verified in light and dark, plus a visual swatch theme picker in the playground and an AA-conformance test so a future theme cannot regress accessibility.
  • An MCP server (mdp-mcp): any MCP host (Claude Desktop, Cursor, ...) can compile MDP via mdp_compile, mdp_present, and mdp_validate, plus mdp://spec and mdp://example/* resources. Install with claude mcp add mdp -- npx -y mdp-mcp.
  • A Codex plugin in codex/ exposing the same mdp skill (codex marketplace add barmoshe/mdp).
  • A hub, live playground, and full docs at https://barmoshe.github.io/mdp/, deployed to GitHub Pages. The playground bundles the real engine, so it compiles with the same code the CLI and plugins run.

Published to npm

  • mdp-compiler — the dependency-free engine (npm i mdp-compiler)
  • mdp-mcp — the MCP server (npx -y mdp-mcp)
  • create-mdp-extension — the scaffolder (npm create mdp-extension)

The engine package was renamed from @mdp/core to mdp-compiler for its npm publish (the @mdp scope is owned by an unrelated party).

Full notes: CHANGELOG.md