Changelog

All notable changes to Bounce Kit are documented here.

Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).

---

v0.3.0 — 2026-03-23

Added

• CLI init command — scaffolds bouncekit.json config, installs base dependencies (tailwindcss, class-variance-authority, clsx, tailwind-merge, lucide-react), creates cn() utility file if missing. Supports --yes flag for non-interactive mode.
• CLI diff command — compares local files against bouncekit-lock.json hashes. Reports modified, deleted, and unchanged files per installed component.
• CLI update command — re-fetches latest component versions from registry, updates files and lock file. Supports --force to overwrite local changes.
• CLI config system — bouncekit.json stores aliases, Tailwind paths, RSC flag, registry URL. bouncekit-lock.json tracks installed components and content hashes.
• Theme customizer page (/themes) — interactive page with 5 color presets (Amber, Blue, Emerald, Rose, Violet), light/dark mode toggle, per-token color pickers, live preview card, and copy-to-clipboard CSS output.
• Component page tabs — Preview / Code / Manual Install tabs on each /components/[slug] page. Source code read at build time for free components; Pro components show no Code tab.
• JSON Schema endpoints — /schema/registry-item.json and /schema/bouncekit.json serve machine-readable schemas for registry items and CLI config. Referenced by $schema in generated files.
• New tests (27 new):

- registry-items.test.ts — 14 tests validating all 107 registry item definitions (names, types, tiers, files, dependency references)

- schema-routes.test.ts — 11 tests validating both JSON Schema route handlers (shape, headers, enums, defaults)

- constants.test.ts — 2 new tests for themes route and nav link

• Themes nav link — added to navbar navigation

Fixed

• cta registry dependency — referenced non-existent cta-matrix; fixed to ["cta-threads", "cta-terminal", "cta-keycard"] matching actual imports
• Lint errors — removed unused filename variable in ManualInstall and unused TokenDef interface in theme customizer
• Focus accessibility — standardized focus: → focus-visible: across Sheet, Dialog, Badge, Select UI primitives
• Showcase aria-label — added missing aria-label to icon-only button in Topbar showcase component

Changed

• CLI output — tightened formatting: removed ASCII banner, clean ✓/→/✗/⚠ log symbols, less branding noise
• CLI version — bumped to 0.2.0 in both cli.mjs and package.json
• CLI README — rewritten with all 5 commands, flags, environment variables, and how-it-works section
• Component page — "Usage" label renamed to "Import" for clarity; CopyBlock refactored with extracted CopyButton

Docs

• README.md — added CLI commands table, /themes route, schema endpoints, updated registry section with init workflow
• CLAUDE.md — added CLI key files, bouncekit.json/lock references, CLI version consistency rule
• agent-context.md — updated CLI description, /themes route, marked CLI DX/themes/schemas/component tabs as done
• architecture.md — added registry/, packages/bouncekit/, schema/ to folder map; added new API routes
• decisions.md — added entries for CLI parity, theme customizer, JSON schemas, component page tabs

---

v0.2.0 — 2026-03-21

Added

• Testing infrastructure — Vitest + Testing Library + jsdom. 43 tests across 3 suites:

- src/lib/__tests__/utils.test.ts — cn(), formatDate(), formatPrice()

- src/lib/__tests__/validations.test.ts — login, signup, forgotPassword, profile Zod schemas

- src/components/ui/__tests__/button.test.tsx — all variants, sizes, disabled, asChild, click events

- Run with npm test · watch mode npm run test:watch · coverage npm run test:coverage

• vitest.config.ts — configured with jsdom, @/ path alias, globals, and v8 coverage
• src/tests/setup.ts — @testing-library/jest-dom matchers registered globally

Fixed

• Stats counter animation not firing on Vercel (stats-strip.tsx) — replaced

useInView({ margin: "-10% 0px" }) with amount: 0.2 threshold and added a

mount-time viewport check. The old rootMargin approach caused a hydration race:

if the user scrolled past the stats section before JS loaded, once: true meant

the IntersectionObserver never fired and all counters stayed at 0.

• JSX tag mismatch in hero section (hero-section.tsx) — opened

on line 124 but closed with

. Fixed to .

Performance

• next.config.ts — Added optimizePackageImports for lucide-react and

framer-motion. Lucide ships 1 400+ icons; explicit tree-shaking hints ensure

only the ~50 icons actually used appear in the bundle.

• NoiseOverlay — Replaced setState(seed) in the 8fps rAF loop with

ref.current.setAttribute("seed", …) — direct DOM mutation bypasses React

reconciliation entirely, eliminating ~480 needless re-renders per minute.

---

v0.1.0

• Initial scaffold