PParable
Documentation menu

Changelog

v0.9 — Template signatures, extracted: 5 new components

83 → 88. The Expansion's best interactions, distilled into installable atoms — each credits the template it came from and links its live source.

  • Waveform Scrubber (from Earshot) — a seekable canvas waveform with seeded deterministic peaks, a simulated transport, pointer-capture drag seeking, and full keyboard control on a role="slider" surface.
  • Caustics Background (from Fathom) — rippling underwater light in raw WebGL1: DPR-capped, off-screen paused, context-loss safe, CSS-gradient fallback, one static frame under reduced motion.
  • Combination Dial (from Oubliette) — rotary spinbutton dials you drag or arrow-key into alignment; the latch opens onto your children when the combination matches.
  • Axis Specimen (from Glyphica) — a variable-font playground: sliders generated from an axes prop drive font-variation-settings on a giant editable specimen, with presets and a copy-ready CSS readout.
  • Force Graph (from Redoubt) — a seeded force-directed canvas graph that settles and stops ticking; hover or keyboard-focus traces a node's neighbourhood.
  • House rules throughout: single self-contained file, zero new dependencies, SSR-deterministic, reduced-motion complete, keyboard operable — plus the v0.8 auto-generated props tables cover all five.

v0.8 — Component docs: props & usage, generated from source

Every component page now documents itself.

  • Props tables — every component's *Props interface is extracted straight from its TypeScript source (name, type, default, required, and the JSDoc description on each prop) at build time. 83/83 components covered; the table can't drift from the code because it is the code.
  • Usage snippets — each page shows the exact JSX that renders its live preview, lifted verbatim from the gallery source.
  • Copy Page & MCP — the LLM-facing markdown export now includes the props table, and the MCP get_component tool returns structured props, so agents get the full API without reading source. (Also fixed: the MCP category filter now knows about block.)
  • Regeneration is chained into registry:build, so docs stay in lockstep with the registry.

v0.7 — The Expansion: 26 new templates

Templates 52 → 78. Twenty-six new product concepts, each an individually-designed, deployed site with its own signature interaction — light/dark themed, reduced-motion aware, and cloneable like the rest.

  • Static (10) — Quench (Damascus-steel domain-warp shader), Beaufort (scroll-steered nautical chart), Cornice (flip-counter lift board + piste map), Lather (CSS barber-pole + chair scheduler), Peony (click-to-launch canvas fireworks), Longbox (halftone comic-panel scroll), Oubliette (combination-lock dial puzzle), Dovetail (orthographic blueprint rotate + material swaps), Fathom (WebGL caustics + ocean depth-column), Selvedge (SVG measurement mannequin + fabric-bolt unroll).
  • Astro (6) — Conche (origin flavor-wheel + tempering curve), Yugen (noren-curtain parallax + bowl-builder), Nightcap (liquid-layer build-a-drink), Vitrine (gallery-wall parallax + floor-plan navigator), Deckle (paper-mode substrate toggle + doodle canvas), Rennet (aging-cave humidity-by-weeks viz).
  • Vite + TS (4) — Halfstep (exploded-assembly e-bike scroll + configurator), Crux (trace-a-route climbing wall), Splits (self-drawing elevation profile + pace calculator), Patchbay (draggable patch cables + opt-in Web Audio).
  • SvelteKit (3) — Endgame (scroll-replayed chess study), Meeplewood (3D-CSS d20 roller + page-flip rulebook), Mise (recipe stepper + ratio slider).
  • Next.js (3) — Glyphica (variable-font axis playground), Redoubt (force-directed threat graph + streaming log), Earshot (seekable canvas waveform scrubber).
  • Every one passed a three-pass polish loop plus an adversarial QA audit (contrast, reduced-motion, keyboard access, no-JS content, 380 px layouts) before deploy, and ships with a styled "How this was built" guide.

v0.6 — Phase 2B Wave 4: 15 new components

68 → 83. Gap-closing wave.

  • Balloon Burst — the marketplace's own copy-command celebration is now an installable component (useBalloons().release()), credited to Artur Bień's balloons-js (MIT), the library that inspired it.
  • Componentry MIT signatures: Matrix Rain, Pixel Canvas, Orbit Card Stack.
  • Cult free tier: Family Button, Morph Surface.
  • AI Chat — the marketplace-safe slice of the AI-interface genre: pure UI (streaming bubbles, typing dots, auto-grow composer, canned demo echo), no backend — by design; see the attribution policy on why full-stack patterns are out of scope.
  • Dashboard pieces (Watermelon-inspired): Bar Chart, Donut Chart, Calendar Heatmap, Kanban Board — all hand-rolled SVG/pointer-DnD, zero chart dependencies.
  • Generic staples (uncredited by design): Multi-Step Form, Image Zoom, Stepper, Skeleton.
  • House rules throughout: deterministic/seeded visuals (SSR-stable), reduced motion fallbacks, single-file, keyboard operable.

v0.5 — Phase 2B Wave 3: 15 new components

53 → 68. The marketing-block tier arrives, plus the last named interaction patterns from the audit.

  • Six marketing-block compositions (Cult-Pro-inspired, pattern-credited): Hero Section, Feature Bento, Testimonial Marquee, CTA Banner, FAQ Accordion, Stats Band. All render buttons by default and real links only when you pass href.
  • Five named interactions: Section Dots (scroll-spy rail), Squircle (real superellipse math), Gooey Toggle (SVG goo filter), Wallet Stack (credited to Family/Benji Taylor upstream), Theme Toggle.
  • Four genre staples: Spotlight Card (credited to Componentry, MIT), and Compare Slider, Morph Tabs, Orbit Icons — deliberately uncredited: they're generic long-standing patterns with no single source, and inventing a credit would be false attribution.
  • House rules throughout: single self-contained file, reduced-motion fallback, SSR-deterministic rendering, focus-visible states, inspiredBy in the registry JSON where a credit exists.

v0.4 — Phase 2B Wave 2: 14 new components

Registry 39 → 53. More paid-tier-inspired originals plus a few utility patterns credited to their true upstream.

  • More Cult free-tier signatures (MIT): Texture Button, Border Beam, Intro Disclosure, Tweet Grid.
  • Skiper-inspired interactions (clean-room from public renderings): AI Input, Peek Carousel, Parallax Hero, ASCII Render, Mega Navbar, Scroll Text Reveal.
  • Utility patterns credited upstream: Command Palette (credited to cmdk by Paco Coursey — self-written, no cmdk dependency), Activity Feed, File Drop, and a gooey Liquid Blobs metaball hero.
  • Same guarantees throughout: single-file, reduced-motion fallback, focus-visible, SSR-safe animation, inspiredBy in the registry JSON.
  • Verified on the production build: 0 nested/interactive-in-anchor, 0 hydration console errors.

v0.3 — Phase 2B Wave 1: 18 new components

The catalog nearly doubled again — 21 → 39 — with the first wave of paid-tier-inspired originals plus the dashboard atomics that rounded out Wave 1.

  • Cult-Pro-inspired primitives (clean-room originals from public renderings, credited as patterns): Shift Card, Notification Stack, Animated Grid, Text Scramble, Text Highlighter, Animated Input, Pricing Table.
  • Skiper-inspired interactions (credited to true upstream where clear): Image Reveal, Cursor Image Trail, Drag Scroll Gallery, Rich Tooltip, Token Swap Card, Hover Member Row, and Family Drawer (credited to Emil Kowalski's Vaul-genre drawer).
  • Dashboard atomics (Watermelon-inspired): Stat Card, Animated Counter, Avatar Stack, Progress Ring.
  • Every component: single self-contained file, reduced-motion fallback, focus-visible states, SSR-safe animation, inspiredBy credit in the registry JSON. The attribution policy now covers the paid-catalog rule explicitly.
  • Verified end-to-end: shadcn add of a v0.2 item from the production registry into a fresh Next app installs file-identical and typechecks.

v0.2 — Wave 1: 14 new components + the design language

The catalog tripled — 7 → 21 components — and the marketplace got its own design language.

  • Prism Drift (dither-aurora) — the new signature: a WebGL ordered-dither aurora (original GLSL, Bayer 4×4 lattice) now rendering the home hero. The hero's primary CTA is the install command for the very shader behind it.
  • 13 more components — Liquid Metal Button, Dynamic Island, Expandable Card, Logo Carousel, Gravity Dots, Split Flap, Gradient Heading, Eye Tracking, Sticky Scroll Cards, and a new Blocks & Slices category: Revenue Chart, Transaction List, Device Frame, Sign-in Slice. Dot Matrix Loader grew 7 variants (wave, orbit, snake, pulse, rain, scan, spiral).
  • Attribution, structurally — components inspired by work we admire now carry an inspiredBy credit in the registry JSON itself and a visible credit line on their page, plus a new licensing & attribution policy. Every inspired-by component is a clean-room original.
  • Design tokens — the Parable palette (--pb-ink/vellum/violet/fuchsia/ ember/signal) and motion tokens (--pb-ease-out/snap, durations) are now real CSS variables; Instrument Serif joins as the display accent face.
  • All 14 new components honour prefers-reduced-motion, ship focus-visible states, and are self-contained single files.

v0.1 — first cut

The marketplace foundation, built in phases.

  • Registry infrastructure — the @parable shadcn registry, generated from source (shadcn build → /r/*.json), never hand-written. Verified end-to-end: shadcn add from the registry installs into a fresh app and resolves dependencies.
  • 7 components across five categories — Shimmer Button, Velocity Marquee, Kinetic Text, Magnetic Dock, Aurora Background, Dot Matrix Loader, Magnet Lines. All reduced-motion aware.
  • Component gallery + detail — category filters, ⌘K command palette, live previews, Preview/Code tabs, package-manager selector, and a "Copy Page" markdown export for LLMs.
  • 52 templates across two families (Parable, Formwork) and five stacks — each a real, deployed site with a live iframe preview, an Open button, and a clone command.
  • MCP endpoint — the catalog exposed over Model Context Protocol so agents can browse and pull directly.

Everything is free and open — every component and template, no account, no paid tier.