Skip to Content

Changelog

Release history for The Circle Health Registry.

v2.0.0 — Canonical Registry

Added

  • Nextra documentation with nested pages for components, blocks, utilities, skills, themes, sample data, concepts, and installation guidance.
  • Copy Review and Link Check skills, published through the registry with copyable agent installation guidance.
  • Brand reference pages for Decades, Praxis Kessler, and Soma Studio.
  • Direct download and copyable URL references for synthetic lab reports and intake forms.

Changed

  • Registry entries now map one-to-one to source modules.
  • Supporting hooks, types, serializers, and copy dictionaries remain installable dependencies but are no longer separate catalog pages.
  • Rating is a component and Support is a block; the mixed general module has been removed.
  • Patient-results metric cards use the neutral reporting modules directly.
  • Analytics helpers now live in the utilities namespace.
  • Documentation navigation now follows the registry’s component and block categories.
  • Registry documentation and metadata consistently use the Circle Health Registry name.
  • Flow previews now fill their available surface.

Removed

  • Duplicate install aliases. Install the owning module instead: form, address, booking-timeline, commerce, flow, media, or patient-results-report.
  • The redundant Spacer component.
  • The legacy unnamespaced /r registry endpoint. Use /circle-ui, /blocks, or /i18n.
  • The unused Storybook workspace and superseded standalone prompts document.

v1.0.0 — Initial Release

The first public release of The Circle Health Registry at registry.circle.health.

Added

Pages

  • Components — Catalog browser for core UI primitives, grouped by function
  • Blocks — Pre-assembled flows and domain patterns built from core UI
  • I18n — Shared locale dictionaries and copy packs
  • Utilities — Utility reference page
  • Themes — Theme browser with live previews
  • Showcase — Featured compositions and usage examples
  • Get Started — Onboarding guides for Components and Blocks

CMS (Registry Content System)

  • Registry Item Catalog (items.json) — 98 indexed component entries with titles, descriptions, namespace assignments, and file mappings
  • Site Configuration (site.json) — Namespace definitions, public paths, source policy, and base style/utils metadata
  • Styles Catalog (styles.json) — Theme definitions with token overrides
  • Registry JSON API (/r/[name]) — Serves cached registry payloads per item with cache headers for CLI consumption
  • Build Pipeline — Automated scripts generating shadcn-compatible registry payloads from source

Core UI Components (30 primitives)

GroupItems
Actions & FeedbackAlert, Badge, Button, Progress Bar, Spinner, Tag
Inputs & FormsCheckbox, Switch, Date Picker, Dropdown, Form, Phone Input, Select With Input, TextArea, TextBox
Navigation & DisclosureBack Button, Link, Sheet, Tabs, Text Link
Layout & ContentCard, Container, Empty, Flex, Spacer, Text, Text With Icon, Timeline

Blocks (62 compositions)

GroupItems
Flow PatternsFloating Flow Actions, Flow, Flow Actions, Flow Button, Flow Head, Flow Options, Flow Progress, Top Bar
CommerceCart Line Item, Commerce, Discount Input, Input Discount, Pricing Table, Pricing Table Row, Product Card, Product Item, Quantity Adjustor
MediaHero Gallery, Image Lightbox, Image With Lightbox, Lightbox, Media, Media Slide, Testimonials Carousel, Text Only Testimonial, Video
BookingBooking Timeline, Booking Timeline Item, Booking Timeline Indicator, Booking Timeline Progress Dot, Booking Timeline Progress Separator, Booking Timeline Step, Booking Timeline Step Basics, Booking Timeline Step Content Notes, Booking Timeline Step Content Directions, Booking Timeline Step Content Todo List, Booking Timeline Todo Status Indicator
Address & SupportAddress, Address Input, Auto Address Inputs, General, Map, Manual Address Inputs, Rating, Support
ComplianceCookie Consent
Reporting PrimitivesMetric Range Card, Metric Donut Card, Metric Split Card, Metric Stat Card, Text Columns Card
Patient ResultsPatient Results Blocks (umbrella), Segment Muscle Analysis, Diagnostic Report Header, Diagnostic Report Footer, Diagnostic Report Intro, Diagnostic Report Page Shell, Patient Results Editor, Patient Results Report, Patient Results PDF, VO2 Max Report, VNS Report, Body Composition Report

I18n Copy Packs

  • Cookie Consent Copy — Shared locale dictionary for the cookie consent block

Themes

  • Berlin — Default Circle Health product palette with warm sand surfaces and blue actions
  • Linen — Brighter editorial variant with softer neutrals and a greener accent
  • Graphite — Cooler, higher-contrast palette for dense internal tooling surfaces

Infrastructure

  • shadcn CLI compatibility — All items installable via npx shadcn@latest add
  • Namespace-based organization — circle-ui, blocks, i18n
  • Berlin registry style — App-first Circle Health tokens and defaults
  • Registry dependency graph — Items declare internal dependencies for automatic resolution
  • Source policy — Primary (circle-app) and secondary (legacy-design-system) source references
  • Storybook 10 integration — Isolated component previews
Last updated on