UIPackage
Menu

Framework

Change language

Boilerplate repo
Timeline & Changelog · React

Release History

The complete chronological journey of UIPKGE from June 2025 to today. From Month 1 monorepo inception and the foundational primitive port to enterprise data tables, 7-sidebar architectures, live chart suites, dual-framework Vue 3.5 & React 19 SSG islands, and global multi-language localization.

Inception
Jun 15, 2025
Month 1 Genesis
Git Commits
570+
Jun 2025 – Today
UI Primitives
91+
Vue & React Mirrors
Composed Blocks
46+
Zero-Edit Copies
ECharts Suite
24
CSS Var Palettes
i18n & Themes
8 / 15
Locales & Palettes
v2.2.0 Global i18n & Enterprise Craft Latest
August 15, 2026 Today · Current 32 commits

Global Multi-Language Engine, RelativeTime & Design Craft Standards

Global multi-language engine supporting 8 languages with zero-refresh swapping. Introduced the relative-time primitive for live auto-updating Intl timestamps. Standardized 40px tab heights, sidebar icon rails, active item indicator bars, and Linear/Raycast design craft standards across the entire component suite.

"Spanning 14 months of engineering from June 2025 to August 2026, this release brings internationalization to global teams across Asia, Europe, and the Americas, paired with live timestamping and strict ergonomic craft standards."

Key Milestones & Changes
  • 8 Global language catalogs (English, Japanese, Simplified Chinese, Traditional Chinese, Spanish, German, French, Korean, Portuguese, Hindi) with reactive zero-refresh locale modal
  • New Primitive: relative-time (Intl live timeago with auto-updating intervals and format styles)
  • Standardized 40px tab heights across all tab triggers and segmented controls
  • Standardized sidebar icon rails and active navigation indicator bars
  • Dual-framework parity maintained across both Vue 3.5 and React 19 mirrors
  • Refined design standards aligned with Linear and Raycast craft benchmarks
Architectural Principle / Decision

Translations are split into UI chrome, component registry descriptions, and demo strings. Client-side DOM hydration via data-i18n attributes ensures instant language switching with zero runtime bundle overhead.

View Key Git Commits (4)
23b914ec feat(i18n): add Japanese translations and setup for i18n support 2026-08-08
c2ab61a0 feat(i18n): add eight language catalogs 2026-08-12
298f26f4 feat(registry): add relative-time primitive with live ticker 2026-08-14
28700986 fix(sidebar,tabs): standardize sizing, tab heights, active highlighting and design standards 2026-08-15
v2.1.0 Tweakcn Studio & Hardware Frames Expansion
August 2, 2026 Month 14 48 commits

Brand Color Switcher (15 Tweakcn Themes), 27 Primitives & Device Frames

Added 27 modern UI primitives (dock, speed-dial, signature-pad, json-tree-view, tree-table, marquee, terminal, video, clipboard, watermark, image-compare, etc.). Brand color switcher featuring 15 real-time tweakcn color palettes. Metallic PaymentCard and realistic Phone hardware device frames.

"Taking visual craft to the pinnacle of modern design engineering. Inspired by Linear and Stripe, we introduced fluid spring motion, interactive credit card faces, hardware phone frames, and comprehensive test suites."

Key Milestones & Changes
  • 27 New Primitives added in both Vue 3.5 and React 19 registries
  • Brand Color Switcher: 15 real-time OKLCH themes (Zinc, Slate, Stone, Gray, Neutral, Red, Rose, Orange, Green, Blue, Yellow, Violet, etc.)
  • Phone Component: Exact viewport chassis for iPhone 17 Pro (Dynamic Island) and Galaxy S26 Ultra (Punch Hole)
  • PaymentCard: Metallic reflection gradient shifts and keystroke-reactive CVV flips
  • XmlTreeView & JsonTreeView: Interactive syntax-colored collapsible hierarchy viewers
  • Comprehensive Vitest test suites covering all primitives across Vue & React

Components Released (17)

registry:ui / chart
dock Navigation

macOS-inspired interactive floating dock with mouse magnification and tooltip labels.

View preview
speed-dial Navigation

Floating action button that blossoms into multiple secondary actions on hover or click.

View preview
signature-pad Forms & Inputs

HTML5 Canvas signature drawing pad with smooth Bezier strokes, clear, and PNG export.

View preview
phone Display

Realistic smartphone hardware frames (iPhone 17 Pro and Galaxy S26 Ultra) for mobile responsive previews.

View preview
payment-card Commerce

Interactive credit/debit card visualization with chip, metallic holographic reflection, and live input mapping.

View preview
xml-tree-view Data Display

Interactive XML explorer with node expand/collapse, syntax highlighting, and node count badges.

View preview
json-tree-view Data Display

Collapsible JSON object inspector with type badge colorization and copy-path shortcuts.

View preview
organization-chart Data Display

Hierarchical corporate tree diagram with connector curves and node expanders.

View preview
tree-table Data Display

Data table supporting nested expandable row hierarchies with indented child nodes.

View preview
circular-progress Feedback

Radial progress meter supporting indeterminate animations, custom strokes, and value center slots.

View preview
gradient-text Display

Smooth multi-stop gradient typography with animated shine effects and preset colorways.

View preview
marquee Display

Silky 60fps infinite scrolling ticker supporting pause-on-hover and reverse directions.

View preview
terminal Display

Command-line terminal window mockup with tabs, prompt styling, and typing animations.

View preview
watermark Display

Rotated security pattern overlay protecting sensitive application screens.

View preview
image-compare Media

Interactive before/after image comparison slider with touch and keyboard drag controls.

View preview
video Media

Custom-styled HTML5 video player with keyboard shortcuts, picture-in-picture, and playback speed.

View preview
clipboard Utilities

One-click copy button with haptic feedback animation and icon transition states.

View preview
View Key Git Commits (4)
78799f9f feat(registry-react): add back-top, block-ui, bottom-navigation, cascade-select, circular-progress, and clipboard components 2026-07-22
09a3c903 feat(site): add brand color switcher with 15 tweakcn themes 2026-07-26
68a3d0d3 feat(payment-card): premium metallic faces and typing pops 2026-07-29
e930cc5b feat(phone): add Phone component with device frames for iPhone 17 Pro and Galaxy S26 Ultra 2026-08-02
v2.0.0 Dual-Framework Super-Migration Major Epoch
July 15, 2026 Month 13 · Major Epoch 65 commits

The Dual-Framework Astro SSG Super-Migration (Vue 3 + React 19) & Next.js Boilerplate

Major architectural transformation: Rewrote the entire documentation site to Astro SSG with live Vue 3.5 and React 19 islands. Brought packages/registry-react into the monorepo for 100% parity (90 Vue + 90 React components, 24 charts, 50 blocks). Shipped the Next.js 16 / React 19 SaaS boilerplate starter.

"Originally starting as a Vue-only registry, UIPKGE unlocked universal frontend utility by adding a first-class React 19 mirror. Alongside the Astro SSG site rewrite, we launched the production-ready Next.js 16 boilerplate repository pre-configured with the full React component library."

Key Milestones & Changes
  • Dual-Framework Architecture: 100% feature parity between Vue 3.5 (Reka UI) and React 19 (Radix UI)
  • Launched Next.js 16 SaaS Boilerplate (App Router + React 19.2 + Radix UI + TypeScript)
  • packages/shared single-sources all design tokens and CVA variant definitions across both frameworks
  • Dual live islands: Every Story renders interactive Vue or React components with zero-hydration penalties
  • View Transitions API: Instant framework switching between /vue and /react with zero layout shifts
  • 24 Dedicated Chart wrappers with full dual-framework support

Templates & Starters Shipped (1)

boilerplate / vertical
Next.js 16 SaaS Boilerplate Boilerplate Starter

Production-grade React 19 & Next.js 16 SaaS starter with Auth, DB, Billing, Email, Analytics, and pre-wired @uipkge-react components.

Next.js 16 · React 19 · TypeScript
Architectural Principle / Decision

Registry items build directly to static JSON manifests: /r/vue/<name>.json and /r/react/<name>.json. The registryAtAlias Vite plugin in Astro compiles either Vue or React source on the fly.

View Key Git Commits (5)
064f44ce feat(astro): unified Vue+React docs site -- shell + dual-registry grids 2026-07-02
0728eb51 feat: bring the React registry into the monorepo (packages/registry-react) 2026-07-06
af1f4833 feat: packages/shared single-sources tokens + cva variants for both registries 2026-07-10
013e8026 feat(templates): add Next.js/React boilerplate starter 2026-07-15
82b800dd feat(site): cut over to Astro dual-framework site, drop registry-site 2026-07-15
v1.7.0 Collaboration & Templates Templates Launch
June 18, 2026 Month 12 54 commits

Hospital (HMS) & Logistics Templates Launch, Collaboration Suite & Sage Palette

Official release of two full-scale reference domain templates: uipkge-hms (99 hospital routes, 7 medical personas) and uipkge-shipment-tracking (22 logistics routes, live fleet map). Shipped workspace chat blocks (chat-thread, inbox, ai-llm-chat), EventCalendar + use-month-grid, and "Sage Paper" signature palette.

"To prove that UIPKGE scales to massive, mission-critical applications, we launched our 99-route Hospital Management system (OPD, IPD, ER, ICU, Pharmacy, Billing) and our real-time Shipment Tracking control tower, completely powered by registry primitives."

Key Milestones & Changes
  • Launched uipkge-hms-nuxt-template: 99 routes across 7 medical role personas (Admin, Doctor, Nurse, Pharmacist, Lab, Receptionist, Accountant)
  • Launched uipkge-shipment-tracking-template: 22 logistics routes with live interactive fleet map and control tower
  • Chat & Messaging Suite: chat-thread, chat-two-pane, inbox (inline reply composer), ai-llm-chat
  • EventCalendar: Monthly scheduling grid powered by @uipkge/use-month-grid
  • Board Primitive: Drag-and-drop workspace board powered by @uipkge/use-board
  • Sage Paper Palette: Calibrated OKLCH color identity delivering high-contrast, eye-friendly aesthetics
  • 3-Round Figma Design Audit: Fixed focus rings, ARIA states, and touch targets across 80+ components

Templates & Starters Shipped (2)

boilerplate / vertical
Hospital Management System (HMS) Full Template

Comprehensive clinical and administrative system across OPD, IPD, ER, OT, ICU, Pharmacy, Lab, Radiology, and Billing with mock data layer.

99 Routes · 7 Medical Roles
Shipment Tracking & Logistics Full Template

Logistics control-tower dashboard, shipment ledger, public tracking lookup, live fleet map, warehouses, and analytics.

22 Routes · 3 Role Personas
View Key Git Commits (4)
8b40295a feat(blocks): add chat-thread, chat-two-pane, inbox, ai-llm-chat 2026-06-05
7a8cfcda feat(blocks): add event-calendar block + use-month-grid hook 2026-06-10
698e479c feat(registry): add Board primitive + useBoard hook 2026-06-14
df7c89cb feat: list uipkge-hms as a live template on the site (99 routes) 2026-06-18
v1.6.0 Charts & Schematics Visual Charts
May 20, 2026 Month 11 46 commits

The Charting Ecosystem & Block Schematic Previews

Charts promoted to first-class registry category with 24 dedicated wrappers. Built custom SVG schematic previews for all block categories. Introduced 3 Analytics Dashboard blocks.

"Data visualization was elevated from a single raw chart wrapper to an extensive ecosystem of 24 purpose-built chart primitives, completely driven by CSS variable themes."

Key Milestones & Changes
  • 24 Dedicated Chart Wrappers: Line, Bar, Area, Pie, Donut, Radar, Scatter, Treemap, Gauge, Funnel, Heatmap, Candlestick, Boxplot, Sunburst, etc.
  • Theme-safe charts: Palette driven by CSS custom properties (--chart-1 through --chart-5)
  • 3 Analytics Dashboard blocks: analytics-overview, cost-breakdown, metrics-grid
  • Block Schematic Previews: Tailored vector schematic cards for immediate visual comprehension without runtime overhead
View Key Git Commits (4)
a7144ef3 feat(charts): promote charts to top-level module with per-chart items 2026-05-08
3bc81cc7 feat(blocks): add 3 analytics-dashboard blocks built on the chart primitives 2026-05-12
fcce9538 feat(blocks-page): add BlockSchematic component 2026-05-16
c6a1aa17 refactor(charts): drive chart palette from CSS vars (chart-1..chart-5) 2026-05-20
v1.5.0 Marketing & Kanban Blocks Expansion
April 22, 2026 Month 10 42 commits

14 Marketing Blocks, Auth Surfaces & Production Kanban

14 Marketing blocks covering heroes, CTAs, bento grids, pricing, and logos. Complete authentication surfaces (Sign-in, Sign-up, MFA, Password-reset). Production Kanban Board mega-block with @uipkge/use-kanban hook and Slack-style OverlayScroll primitive.

"Landing page builders and SaaS teams needed full marketing page sections and turn-key auth workflows. This release delivered everything required to build a marketing site and user auth flow in minutes."

Key Milestones & Changes
  • 14 Marketing Blocks: hero-01, cta-01, features-01, bento-01, pricing-01, testimonials-01, faq-01, header-01, logos-01/02/03, contact-01, footer-01
  • Auth Suite: login-01, login-02, register-01, auth-mfa, auth-password-reset with Zod schemas
  • Kanban Board: Full drag-and-drop task board with column swimlanes and priority tags
  • OverlayScroll: Slack-style custom scrollbar with wheel chain capture
  • Branded data-uipkge attribute added across all component primitives
View Key Git Commits (4)
0a12db8c feat(blocks): add login-01, login-02, register-01 (auth category) 2026-04-05
54ec2401 feat(blocks): add 7 marketing blocks (hero/cta/features/pricing/footer/testimonials/contact) 2026-04-12
95976e9b feat(blocks): port HRMS kanban surface (kanban-board mega-block + use-kanban hook + kanban-data lib) 2026-04-18
52409fc1 feat(overlay-scroll): port Slack-style overlay scrollbar from P-ETA 2026-04-22
v1.4.0 Sidebar Suite Sidebar Suite
March 25, 2026 Month 9 62 commits

The Application Sidebar Suite (7 Variations) & Consumer Sweep Engine

Shipped 7 distinct Application Sidebar architectures (sidebar-01 to sidebar-07) including dual-rail HRMS shells, toolbar docks, and tree connectors. Form migration to TanStack Vue Form + Zod. Automated Playwright test sweep verifying real-world consumer installs.

"Application navigation makes or breaks complex web apps. We designed 7 production-grade sidebar blocks catering to everything from lean SaaS dashboards to complex dual-rail enterprise platforms."

Key Milestones & Changes
  • 7 Sidebar Variations: Standard, Collapsible Rail, Inset, Floating, Dual-Rail (Slack/HRMS), Tree-Style, and Bottom Toolbar
  • Form architecture modernized from vee-validate to TanStack Vue Form + Zod
  • Zero-edit demo page.vue shipped with every block for instant copy-paste installation
  • Automated Playwright headed browser sweep testing real-world installs across all registry items
  • Fixed 27+ TypeScript typecheck edge cases across 24 components
View Key Git Commits (4)
f48815a4 feat(blocks): add app-sidebar block (sidebar-07-style) 2026-03-08
b6fa588c refactor(blocks/sidebar-05): rebuild as dual-rail HRMS shell 2026-03-15
0559af2c feat(form): migrate Form block from vee-validate to TanStack Vue Form + Zod 2026-03-20
8ebaef8f feat(sweep): Playwright headed browser smoke + screenshots 2026-03-25
v1.3.0 Architecture & Specs Architecture
February 24, 2026 Month 8 · Architecture 35 commits

The Primitive vs Block Law & SFC Variant Decoupling

Established the foundational UIPKGE architectural principle: Primitive vs Block Boundary (banning StatCard, making KpiGrid pure layout). Emitted shadcn-vue spec-compliant JSON with automated test verifier. Resolved Vue 3.5 SSR circular import traps by extracting cva variants to sibling files.

"To ensure long-term registry purity and eliminate SSR build traps, we codified the architectural boundaries between primitives and blocks. Primitives abstract rendering mechanics; blocks compose layouts with full internal visibility."

Key Milestones & Changes
  • Primitive vs Block Boundary Law: Primitives never take raw item data; blocks never hide tile markup
  • Removed StatCard primitive; slot-ized KpiGrid into pure structural layout
  • Created automated shadcn-vue JSON specification verifier
  • Extracted CVA variant definitions into <name>.variants.ts sibling files, curing Vue 3.5 SSR warnings
  • Reworked /components gallery with interactive mini-previews and terminal code cards
Architectural Principle / Decision

Codified in DECISIONS.md (D17). Circular imports between Vue SFCs and their re-exporting index.ts break SSR rendering under Vite. Placing cva variants in dedicated sibling files guarantees clean module initialization.

View Key Git Commits (4)
3e220d68 refactor(registry): primitive-vs-block boundary; remove StatCard, slot-ize KpiGrid 2026-02-05
fa18593d test(registry): add spec-compliance verifier 2026-02-12
87e1da16 fix(card): break Card.vue <-> index.ts circular import causing SSR warning 2026-02-18
5ef607c4 feat(registry-site): /components page revamp for prod-ready bar 2026-02-24
v1.2.0 Craft & Primitives Craft
January 18, 2026 Month 7 48 commits

Timeline Overhaul, Modals Consolidation & 7 Advanced Primitives

Pixel-aligned single connector line for Timeline with media and status indicators. Modal consolidation (AlertModal + Dialog replacing AlertDialog). Added 7 advanced primitives: Knob, Anchor, VirtualList, Mentions, Transfer, Tour, lazy-image (Img), vertical-tabs, and IconTransition. Expanded 40+ thin demos.

"Focusing on fine-grained visual craft and missing enterprise UI primitives. We overhauled the Timeline component to use single pixel-aligned SVG lines and consolidated redundant modal abstractions."

Key Milestones & Changes
  • Timeline Redesign: Single absolute connector line per item with TimelineMedia, direction, and side alignment
  • Modals Consolidation: Replaced legacy AlertDialog with streamlined AlertModal + Dialog
  • 7 New Primitives: Knob, Anchor, VirtualList, Mentions, Transfer, Tour, lazy-image (Img)
  • IconTransition: Smooth morphing animation for copy-button clipboard swaps
  • Expanded 40+ thin component demos to multi-story interactive coverage
View Key Git Commits (5)
d22c48e6 Make Timeline connector a single absolute line per item, pixel-aligned. 2026-01-05
d9bf5c91 Consolidate modals: replaced AlertDialog with AlertModal + Dialog. 2026-01-09
ed75f157 Add IconTransition primitive (registry item) + landing-page clipboard animations. 2026-01-12
b10a8a10 Add VirtualList component to registry. 2026-01-15
defe9529 Add Tour component to registry. 2026-01-18
v1.1.0 Form Powerhouse Forms
December 5, 2025 Month 6 36 commits

Unified DatePicker, 27-Story Combobox & Ant Design Parity

Unified DatePicker (merging range and time into a single component). Added comprehensive 27-story Combobox. Enhanced 10 input components for Ant Design parity (MaskedInput, enhanced PinInput, QRCode). Form status helpers: FormActions, FormSection, FormStatus, and enhanced FormItem.

"Forms are the core workhorse of every B2B application. We overhauled our input controls to match the depth and reliability of mature component libraries like Ant Design while maintaining clean shadcn ergonomics."

Key Milestones & Changes
  • Unified DatePicker: Single robust component supporting single date, date ranges, and time selection
  • Combobox Mega-Component: 27 multi-story test cases covering grouping, async search, and multiselect
  • 10 Input Enhancements: MaskedInput (phone, SSN, currency masks), PinInput auto-focus, QRCode generator
  • Form Scaffolding Helpers: FormActions, FormSection, FormStatus, and FormItem
View Key Git Commits (4)
c027611a refactor(date-picker): unify range + time into single component 2025-11-25
84570b71 feat(combobox): add comprehensive Combobox component with 27 demos 2025-11-28
878598bf feat(form-elements): enhance 10 input components to match Ant Design parity 2025-12-01
4bb49cb8 feat(form): add FormActions, FormSection, FormStatus helpers + enhanced FormItem 2025-12-05
v1.0.0 Public Launch v1.0 Launch
October 28, 2025 Month 5 · v1.0 Launch 52 commits

Official v1.0 Public Launch, Nuxt Boilerplate & HRMS Template

Official public release of UIPKGE at uipkge.dev. Shipped the Nuxt 4 SaaS Boilerplate starter and the uipkge-hrms reference application (16 routes). Full initial suite of 80+ UI primitives and 15 composed blocks. Custom SSR Story island preview architecture with live component rendering and Shiki syntax highlighting. Command Palette (⌘K) search and llms.txt index.

"Reaching v1.0 marked UIPKGE readiness for production applications. We validated the composition model by shipping the full Nuxt 4 SaaS starter boilerplate alongside our reference HRMS template and 15 composed business blocks on Cloudflare Pages."

Key Milestones & Changes
  • Official Domain Launch: Live registry site at https://uipkge.dev
  • Shipped Nuxt 4 SaaS Boilerplate Starter (Nuxt 4 + Tailwind v4 + Reka UI + TypeScript)
  • Shipped uipkge-hrms-nuxt-template: Reference HRMS app with 16 routes and 3 role personas (Admin, Manager, Employee)
  • 15 Composed Blocks: HRMS dashboard tiles, employee tables, leave management, payroll summaries, and security forms
  • Full suite of 80+ foundational UI primitives available via single command installs
  • Custom Story Previews: Lightweight SSR preview cards with interactive state variants and code tabs
  • Command Palette (⌘K) search and dynamic sitemap
  • Consolidated docs + llms.txt and llms-full.txt generation for AI code assistants

Templates & Starters Shipped (2)

boilerplate / vertical
Nuxt 4 SaaS Boilerplate Boilerplate Starter

Production-grade Vue 3 & Nuxt 4 SaaS starter with Auth, DB, Billing, Email, Analytics, and pre-wired @uipkge components.

Nuxt 4 · Vue 3.5 · Tailwind v4 · TypeScript
HRMS Reference Application Full Template

Reference HRMS template — dashboard, people directory, time-off, reviews, recruiting pipeline, and headcount analytics across 3 role personas.

16 Routes · 3 Role Personas
View Key Git Commits (5)
7208d4f2 feat(site): canonical domain uipkge.dev + single-source registry components 2025-10-12
27c43258 feat(site,docs): production-grade landing + reference HRMS template 2025-10-15
928f278d feat(blocks): ship 15 composed blocks for HRMS-style apps 2025-10-18
5e0fbb62 feat: drop Storybook, replace with custom preview pages 2025-10-22
7bda6837 feat(docs): per-component Markdown + llms.txt + consolidated docs.md 2025-10-28
v0.8.0 Data Engine & Motion DataTable
September 10, 2025 Month 3 44 commits

3-Tier Enterprise DataTable Engine & Micro-Interactions Pass

Built a 3-Tier Enterprise DataTable Engine (Tier 1: selection/sticky/density/actions; Tier 2: expansion/pinning/infinite scroll/CSV; Tier 3: virtual scroll/grouping/reorder). DataTableColumnHeader click-to-sort and Popover filter modes. Dedicated /setup onboarding page. Research-backed UX micro-interactions pass.

"Data tables are the lifeblood of enterprise software. Rather than basic HTML wrappers, we engineered a high-performance 3-Tier data table capable of handling virtualized datasets, pinned columns, and multi-mode filtering."

Key Milestones & Changes
  • 3-Tier DataTable: Tier 1 (selection, sticky headers, density, row actions), Tier 2 (expansion, pinning, infinite scroll, resize, CSV export), Tier 3 (virtual scroll, grouping API, column reorder)
  • DataTableColumnHeader with instant click-to-sort and direction indicators
  • Popover & Sheet Filter Modes with #custom-filters slot
  • Dedicated /setup onboarding documentation page
  • UX Micro-interactions Pass: Eliminated 15px layout shifts on popovers, smoothed tab indicators, and added reduced-motion guards
View Key Git Commits (5)
63ce83c6 feat(data-table): tier 1 — selection, sticky header, density, slots, row actions 2025-08-25
6cc84ea8 feat(data-table): tier 2 — expansion, pinning, infinite scroll, resize, CSV 2025-08-30
2d57c8e2 feat(data-table): tier 3 — virtual scroll, grouping API, column reorder 2025-09-04
72a7bfd1 feat(data-table): add DataTableColumnHeader for click-to-sort 2025-09-08
e86b1acd feat(ux): research-backed micro-interaction polish 2025-09-10
v0.4.0 Core Primitives Primitives
July 22, 2025 Month 2 38 commits

The Core 25 Primitives & Preview Architecture

Shipped the first major wave of 25 core UI primitives including Card, Dialog, Sheet, Popover, Tabs, Input, Select, and Sidebar. Designed the 3-column preview layout with scrollspy and auto-extracted code snippets.

"In Month 2, we rapidly established the core interactive primitives that form the backbone of modern web applications. Each component was built with accessibility focus traps, keyboard navigation, and responsive ergonomics."

Key Milestones & Changes
  • 25 Core Primitives: Card, Dialog, Sheet, Popover, Tabs, Input, Select, Sidebar, Tooltip, DropdownMenu, Avatar, Badge, Checkbox, RadioGroup, Switch, Table, Textarea
  • Interactive 3-column layout with category sidebars and sticky navigation
  • Accessible Reka UI headless foundation for polymorphic rendering
  • Pre-paint guard scripts to eliminate light/dark theme flashes
View Key Git Commits (3)
be253703 feat(site): Storybook-style preview pages with live component renders 2025-07-05
abfa8c50 feat(site): add live demos for ~25 more components 2025-07-12
cf94d2ef feat(preview): 3-col layout with component sidebar, full-width header 2025-07-22
v0.1.0 Genesis Genesis
June 15, 2025 Month 1 · Inception 28 commits

Project Genesis, Token Architecture & First Component

Inception of the uipkge/ui monorepo. Established core philosophy: "Components are the product" (unbundled, own-your-code distribution via shadcn CLI). Ported Button as the first primitive. Shipped @uipkge/tailwind OKLCH tokens and bootstrap registry items.

"UIPKGE was born out of frustration with rigid npm UI component packages that bloat bundle sizes and fight custom styling. On Day 1, we established our open-source registry architecture to give developers full ownership of their code."

Key Milestones & Changes
  • Monorepo Scaffolded: apps/astro-site, packages/registry-vue, packages/registry-react, packages/shared
  • The Registry Model: Components install directly into consumer source code via npx shadcn-vue add <url>
  • First Component Ported: Button (92ef2d1f) with 6 variants and 4 sizes
  • Tailwind CSS v4 token hierarchy using OKLCH color spaces and @theme inline
  • Bootstrap registry items: init, tailwind, utils, use-theme
  • Architectural Decision Log (DECISIONS.md) committed
Architectural Principle / Decision

Codified in DECISIONS.md (D01-D04): Distribution via raw registry JSON over HTTP. No npm semver packages, no Nuxt module wrapper. Consumers own their code completely.

View Key Git Commits (4)
6c769560 init: scaffold uipkge/ui monorepo 2025-06-15
92ef2d1f feat(registry): port button as first component 2025-06-15
6419e6d3 feat(bootstrap): @uipkge/tailwind ships full token set 2025-06-20
fe95a555 docs: add DECISIONS.md — full architectural log 2025-06-28