Vandoko Registry Changelog

v0.9.0Registry2026-05-08

Fumadocs Alignment Arc

Notebook layout — switched to Fumadocs Notebook with tabMode="navbar"; replaced standard DocsLayout across /docs/(.*)
black preset + preset.css — adopted the Fumadocs black preset engine; dropped the hand-mapped --color-fd-* block; oklch surface ladder and cyan accent override now applied via .dark only
Iframe component preview — components/docs/component-preview.tsx renders previews inside an iframe so the desktop / tablet / mobile device toggles actually trigger Tailwind breakpoint reflow. ResizeObserver on documentElement, rAF-throttled, 400px floor
Post-login member home /home — server-side auth() redirect from / for org members. Welcome strip + install command, 4 quick-action cards (Components, API Keys, Brand, Changelog), Latest 6 entries from getRegistryIndex(). Org-gated layout mirrors /admin
Native Notebook TOC — switched to style: "clerk"; replaced the deprecated tableOfContent.component slot which Notebook silently ignored
Page centering — removed --fd-layout-width: 100vw and .fd-page { max-width: none } overrides (Notebook handles centering natively)
Cleanup — theme-editor route deleted, admin sidebar pruned, GitHub URL fixed (vandoko → Vandoko-Agency/vandoko-registry), ~70 lines of .preview-container CSS patchwork removed from app/globals.css
/preview/(.*) public route — added to the Clerk middleware whitelist for the new iframe preview surface

v0.8.0Registry2026-05-07

Brand v2 + Theme Consolidation

Sand family — --sand, --sand-light, --sand-whisper warm premium-accent ramp added to vandoko-theme. Available but not consumed on the registry app
Warm-whisper --foreground — shifted from cool-white oklch(0.96 0.01 285) to warm oklch(0.93 0.018 70). v2 lock 2026-05-06; HSL→oklch approximation of vandoko-ai's hsl(38 16% 92%)
Lime quarantine — new vandoko-campaign-tokens registry:base block ships --brand-lime separately. Consumers wanting lime accents must explicitly install the campaign-tokens block; chart/gauge/heatmap inline literals unchanged
--muted-fg-low / --muted-fg-vlow — AA-verified replacements for opacity 0.4–0.7 stacks; ≥4.5:1 against --background
Inter Tight 800/900 — --font-display now leads with var(--font-inter-tight); every existing font-display consumer picks up the prestige typeface on next render
RegistryLatest stripe — editorial "what's recent" section between BlueprintPanel and MembersBuild; renders the 3 most-recently-curated entries (server component, zero client JS)
MembersBuild dogfood — three faux-browser-chrome cards showcasing Vandoko-controlled sites (Vandoko AI, Agent-C Discovery, Vandoko Registry); image bridge ships with ShipmentPlaceholder mode until real screenshots drop
Theme consolidation — prestige editorial layer (--obsidian, --surface-1/2/3, shadow set, --rank-1..6, --font-display) moved out of app/globals.css into vandoko-theme.css. Single source of truth for brand tokens; downstream consumers installing @vandoko/vandoko-theme get the prestige + a11y layer in one CLI step
A11y baseline — universal *:focus-visible cyan ring (2px outline, 2px offset), smooth-scroll gated behind prefers-reduced-motion: no-preference, new lib/respects-reduced-motion.ts helper. Mirrored from vandoko-ai-site to keep the two repos in lockstep
Motion contract — docs/brand/motion-rules.md codifies card-hover banned / approved / pending patterns and the cross-repo motion budget
Obsidian neutralize ×2 — chroma dropped to 0 across the neutral surface ladder (hue 285 was registering as a navy cast); same fix applied to BlackHole's Canvas color constants
Single-CTA invariant — gallery hero CTA stack collapsed to a single CTA per the prestige-pivot rule

v0.7.0Registry2026-04-30

Landing Prestige Pivot

StatementHero — full-bleed obsidian hero with editorial typography; replaced the grid-tunnel hero on the marketing landing
BlueprintPanel — registry rank table (top categories with real counts) plus a 4×36 cyan-ramp density heatmap; embeds an ArcGauge in blueprint variant
CinematicClose — closing editorial section with quiet-authority typography
SingleLine — single-line marketing-section primitive
vdk-grid-tunnel — perspective SVG terrain grid registry block. Vanishing point at 72%/38%, 18 chaotic contour lines (sin-hash deterministic noise) over 20 perspective lines. Pure server component, zero client JS. Ported from vandoko-ai-site TerrainGrid, re-tokened from HSL to oklch
Prestige tokens (additive) — --obsidian, --surface-1/2/3, --shadow-card/signal/cta-glow/sheet, --rank-1..6, --font-display. All --background, --card, --brand-* values unchanged
arc-gauge blueprint variant — variant="blueprint" adds a count-up animation 0 → value over ~860ms (ease-out cubic). Honors prefers-reduced-motion: reduce (snaps to final). Backward compatible
blackhole motion safety — RAF loop short-circuits to a static gradient fallback on prefers-reduced-motion: reduce; IntersectionObserver pauses the loop while offscreen and resumes (with lastTime reset) on re-entry. Documented next/dynamic({ ssr: false }) consumer pattern
Glass card pattern — registry support for the prestige glass-card aesthetic alongside the dataviz showcase
Pre-auth foundations — header / footer / shared site primitives positioning the registry as a portfolio surface for unauthenticated visitors

v0.6.0Registry2026-04-27

Auth Hardening + Dataviz Purity

Clerk v7 / Core 3 — @clerk/nextjs upgraded to v7; middleware migrated to Core 3 patterns. signInUrl / signUpUrl now passed explicitly to clerkMiddleware
Zod env validation — lib/env.ts split into client-safe + server-only modules; all-or-nothing validation with SKIP_CLERK escape hatch retained for Vercel build-time prerender safety
/r/* middleware gating — fix for Next.js public/ shadowing route handlers; auth must live in middleware, not the route file
shadcn CLI 4.5 — devDependency bumped 3.0.0 → 4.5.0; pnpm-lock synced to the ^4.5.0 specifier
Dataviz tokens — pure CSS-var consumption — charts, gauges, heatmaps consume var(--chart-N) / var(--gauge-*) / var(--heatmap-*) exclusively. New tokens declared in cssVars.theme so consumer installs receive them automatically. v4 schema alignment
Code-block container styling — unified across docs pages
SOUL + OPERATOR pointer — CLAUDE.md upgraded to reference the Vandoko SOUL of work + working contract via vkagents/vandoko-manifest.json; agent-c discovery surface linked

v0.5.0Registry2026-03-27

Production Launch + Platform Polish

Clerk production auth — upgraded from test keys to production with Google OAuth, custom domain clerk.vandoko.com
ScrollProgress TOC — custom SVG scroll indicator replaces native Fumadocs TOC on all docs pages (text + component detail)
Hero variants — DotBackground (CSS-only, zero JS) and SpotlightHero (CSS custom props, no framer-motion) added to ace-hero-01
Gallery card redesign — removed placeholder icon, added React 19.2.4 / Next.js 16.2.1 compatibility pills, brushed metal gradient preserved
Props table cleanup — removed redundant "Props" header text from PropsTable card
Navigation cleanup — removed duplicate GitHub sidebar link, theme editor converted from iframe to external link
Docs landing — flat bg-card hero (eliminates gradient banding), sections aligned with hero width
Code block theming — one-dark-pro Shiki theme for cool zinc syntax tokens, --card background pinned outside CSS layers
Container centering — global .container { mx-auto } fix for Tailwind 4
Registry deduplication — 19 duplicate gallery entries resolved via seen Set in getRegistryIndex()

v0.4.0Registry2026-03-26

Next.js 16 + Fumadocs 16 Upgrade

Next.js 16.2.1 — upgraded from 15.5.14
React 19.2.4 — upgraded from 19.1.0
Fumadocs 16.7.6 — upgraded from 15.8.5 (1 import path change: fumadocs-ui/page → fumadocs-ui/layouts/docs/page)
fumadocs-mdx 14.2.11 — patch update from 14.2.6
CSS prose link overrides — prevent Fumadocs cyan underlines on button-styled links
Conditional TOC — re-enabled native TOC for text pages, disabled for component pages
Removed redundant .dark CSS block — dark-mode-only site with forced defaultTheme
CLI docs fix — corrected non-existent --registry flag in installation guide and CLAUDE.md

v0.3.0Registry2026-03-26

Aceternity Expansion + Brand Token Alignment

60 new Aceternity components — heroes, features, pricing, testimonials, cards, backgrounds, navigation, layouts
7 preview wrapper files — preview-wrappers-ace-heroes.tsx, ace-features.tsx, ace-pricing.tsx, ace-testimonials.tsx, ace-cards-logos.tsx, ace-sections.tsx, ace-nav-layout.tsx
Brand token alignment — primary cyan oklch(0.844 0.1457 209.3), accent lime, surface hue 285
Landing page redesign — SVG brandmark, "Component Registry" title, dynamic stats, CLI command display
38 named export mismatches fixed — JSX.Element errors, motion type fixes
Total: 175 deployed components

v0.2.5Registry2026-03-24

Semantic Blocks + Source-First Architecture

19 semantic-named @vandoko blocks from brand-engine registry (hero-saas, hero-agency, pricing-cards, pricing-toggle, testimonials-grid, testimonials-marquee, features-grid, logo-cloud, footer-marketing, faq-accordion, cta-banner, contact-form, blog-grid, team-cards, and more)
70 extracted components synced from brand-engine to registry
Preview map wired — all 19 semantic blocks connected to component preview system
Source-first architecture — components exist as real .tsx files, registry JSON generated from source

v0.2.0Registry2026-02-05

Platform Expansion

Added Clerk authentication for private registry access
Admin dashboard with API key management
Namespace management UI for registry configuration
Brand guidelines section with Supabase storage
Tweakcn theme editor integration (iframe MVP)
Changelog section in documentation

v0.1.5Registry2026-02-11

shadcnblocks Component Expansion

Registry expanded from 8 to 78 curated components via new naming convention (scb- prefix for shadcnblocks)
70 components populated with upstream source code and oklch theming
Component categories: Heroes (scb-hero-01–05), Cards (scb-card-01–05), Testimonials (scb-testi-01–05), Features (scb-feat-01–05), Pricing (scb-price-01–05), CTAs (scb-cta-01–05), FAQs (scb-faq-01–05), Footers (scb-foot-01–05), Backgrounds (scb-bg-01–05), Buttons (scb-btn-01–05)
All components: oklch color conversion, Vandoko design token integration, Props interface extraction
MIT licensed shadcnblocks source with full lineage tracking

v0.1.0Registry2025-01-19

Initial Release

Launched registry with 8 curated components
Hero Highlight, Hero 3, Feature 4, Pricing 4, Testimonial 1, CTA 3, FAQ 2, Footer 3
oklch color system integration
Fumadocs documentation site
Component preview system with live rendering

Vandoko Registry

On this page