chore: update README and documentation to reflect current status of 68 installable components

Shewart · Shewart · commit 11a3b808c8a2 · 2026-06-17T16:11:11.000+02:00
This commit updates the README, versioning strategy, and various documentation files to accurately represent the current status of ShellUI, which now includes 68 installable components. Changes include adjustments to component counts, installation instructions, and examples throughout the documentation to ensure clarity for users. The version has been bumped to v0.3.0-alpha.3 to reflect these updates.
diff --git a/README.md b/README.md
@@ -39,12 +39,12 @@ ShellUI transforms Blazor component development with a hybrid approach:
 - Powered by Tailwind CSS v4.1.18 (standalone CLI - no Node.js required!)
 - Best of both worlds: flexibility when you need it, convenience when you want it
 
-## Current Status: 100 Components (Alpha) 🎉
+## Current Status: 68 Components (Alpha) 🎉
 
 **ShellUI is in alpha!** Test and provide feedback before we ship stable. We've completed:
 - ✅ **CLI Tool** (`dotnet tool install -g ShellUI.CLI`)
 - ✅ **NuGet Package** (`dotnet add package ShellUI.Components`)
-- ✅ **100 Components** with Tailwind v4.1.18 *(actual components only; *-variants, *-service auto-installed)*
+- ✅ **68 Installable Components** with Tailwind v4.1.18 *(top-level components you `shellui add` — sub-components, variants, models, and services auto-install as dependencies)*
 - ✅ **Hybrid Workflow** (CLI + NuGet)
 - ✅ **No Node.js Required** (Standalone Tailwind CLI)
 - ✅ **Comprehensive Documentation**
@@ -96,7 +96,7 @@ To update ShellUI version across all components:
 
 This single file change updates:
 - ✅ All NuGet packages (`ShellUI.CLI`, `ShellUI.Components`)
-- ✅ All component templates (~100 installable components)
+- ✅ All component templates (68 installable components)
 - ✅ Build configurations and metadata
 
 **Example for pre-release:**
@@ -116,25 +116,30 @@ Results in version: `0.3.0-alpha.2`
 
 **For Advanced Users:** Future versions may support component-specific versioning for power users who need granular control.
 
-### ✅ 100 Production-Ready Components
+### ✅ 68 Production-Ready Components
 
-**Form Components (14):**
-Button, Input, Textarea, Select, Checkbox, RadioGroup, RadioGroupItem, Switch, Toggle, Label, Slider, Form, InputOTP
+Counts below are top-level components you can `shellui add` directly. Sub-components (e.g. `SidebarTrigger`, `DialogContent`, `TableRow`), variants (`ButtonVariants`, `AlertVariants`, …), models, and services auto-install as dependencies and are not counted.
 
-**Layout Components (15):**
-Card, Dialog, Sheet, Drawer, Popover, Tooltip, Separator, ScrollArea, Resizable, Collapsible, Accordion, Breadcrumb, BreadcrumbItem, Sonner, Toast
+**Form (17):**
+Button, Checkbox, Combobox, DatePicker, DateRangePicker, FileUpload, Form, Input, InputOTP, Label, RadioGroup, Select, Slider, Switch, Textarea, TimePicker, Toggle
 
-**Navigation Components (12):**
-Navbar, Sidebar, NavigationMenu, NavigationMenuItem, Menubar, MenubarItem, Pagination, Tabs, Stepper
+**Layout (12):**
+Accordion, Breadcrumb, Card, Collapsible, DashboardLayout01, DashboardLayout02, LinkCard, Navbar, Resizable, ScrollArea, Separator, Sidebar
 
-**Data Display (14):**
-Table, TableHeader, TableBody, TableRow, TableHead, TableCell, DataTable, Badge, Avatar, Alert, Toast, Sonner, Skeleton, Progress, Loading
+**Navigation (7):**
+ContextMenu, Menubar, NavigationMenu, Pagination, PrevNextNav, Stepper, Tabs
 
-**Interactive Components (8):**
-Dropdown, Command, ContextMenu, HoverCard, ThemeToggle, EmptyState, FileUpload
+**Overlay (8):**
+AlertDialog, Command, Dialog, Drawer, Dropdown, HoverCard, Popover, Sheet
 
-**Advanced Components (18):**
-Calendar, DatePicker, DateRangePicker, TimePicker, Combobox, AlertDialog, Carousel, Charts (Chart, BarChart, LineChart, PieChart, AreaChart, MultiSeriesChart), CarouselItem, CarouselContent, CarouselPrevious, CarouselNext, CarouselDots
+**Data Display (13):**
+AreaChart, Avatar, Badge, BarChart, Calendar, Carousel, Chart, ChartSeries, DataTable, LineChart, MultiSeriesChart, PieChart, Table
+
+**Feedback (9):**
+Alert, Callout, EmptyState, Loading, Progress, Skeleton, Sonner, Toast, Tooltip
+
+**Utility (2):**
+CopyButton, ThemeToggle
 
 ### ✅ Tailwind CSS v4.1.18 Integration
 
@@ -252,7 +257,7 @@ shellui init
 shellui add button input card dialog
 # Or: dotnet shellui add button input card dialog
 
-shellui list  # See all 100 available components
+shellui list  # See all 68 available components
 # Or: dotnet shellui list
 ```
 
@@ -294,7 +299,7 @@ Simply edit the component file in `Components/UI/` - it's yours to modify!
 | Hybrid Workflow | ✅ | ❌ | ❌ | ❌ |
 | Free & Open Source | ✅ | ✅ | Partial | ✅ |
 | Customization | Full | Limited | Limited | Limited |
-| Components | 100+ | 70+ | 50+ | 80+ |
+| Components | 68 | 70+ | 50+ | 80+ |
 | Current Status | Production Ready | Mature | Commercial | Mature |
 
 ## 📦 Package Overview
@@ -606,7 +611,7 @@ MIT License - See LICENSE.txt for details
 
 ## Status
 
-**Alpha:** 100 components, CLI + NuGet, Tailwind v4.1.18. Test before stable.
+**Alpha:** 68 components, CLI + NuGet, Tailwind v4.1.18. Test before stable.
 **🚀 Ready to use today!**
 
 ---
diff --git a/VERSIONING_STRATEGY.md b/VERSIONING_STRATEGY.md
@@ -6,8 +6,8 @@ ShellUI follows a **unified versioning approach** where all components, CLI, and
 
 ## Version Number: v0.3.0-alpha.2 ✅
 
-**Current Release:** v0.3.0-alpha.2
-- ✅ 100 production-ready components
+**Current Release:** v0.3.0-alpha.3
+- ✅ 68 installable production-ready components
 - ✅ CLI tool + NuGet packages
 - ✅ Full Blazor WebAssembly + Server support
 - ✅ Tailwind CSS v4.1.17 integration
@@ -25,7 +25,7 @@ ShellUI follows a **unified versioning approach** where all components, CLI, and
 
 **Automatically Applied To:**
 - ✅ All NuGet packages (`ShellUI.CLI`, `ShellUI.Components`, `ShellUI.Core`)
-- ✅ All ~100 component templates
+- ✅ All 68 installable component templates (167 templates total including dependencies)
 - ✅ Build configurations
 - ✅ Component metadata
 
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
@@ -15,7 +15,7 @@ ShellUI is a CLI-first Blazor component library that copies components directly
 - ComponentInstaller (add, update – resolves dependencies, writes files)
 - ComponentManager (list, remove)
 
-**ShellUI.Templates** (embedded in CLI) provides ComponentRegistry with 139 templates. `GetComponentContent(name)` returns Razor/C# source.
+**ShellUI.Templates** (embedded in CLI) provides ComponentRegistry with 167 templates total (68 installable top-level components + sub-components, variants, models, services that auto-install as dependencies). `GetComponentContent(name)` returns Razor/C# source.
 
 **Packages:** ShellUI.Core (models/config), ShellUI.Components (NuGet – components, variants, services, theme CSS).
 
@@ -30,19 +30,18 @@ ShellUI is a CLI-first Blazor component library that copies components directly
 
 ## Component Counts (Actual Components Only)
 
-When you run `shellui add button`, that counts as **1 component**. Dependencies (button-variants, etc.) are auto-installed and **not** counted.
-
-| Category | Installable | Description |
-|----------|-------------|-------------|
-| Form | 14 | Button, Input, Select, Checkbox, Switch, etc. |
-| Layout | 15 | Card, Dialog, Sheet, Drawer, Popover, etc. |
-| Navigation | 12 | Navbar, Sidebar, Tabs, Breadcrumb, etc. |
-| Data Display | 14 | Table, Badge, Avatar, Alert, Toast, Sonner, etc. |
-| Feedback | 8 | Toast, Sonner, Loading, Skeleton, Progress, etc. |
-| Overlay | 10 | Dialog, Sheet, Drawer, Tooltip, Popover, etc. |
-| Charts | 9 | Chart, BarChart, LineChart, PieChart, etc. |
-| Utility | 18 | ThemeToggle, CopyButton, ScrollArea, etc. |
-| **Total** | **~100** | *Actual components only; *-variants, *-service excluded* |
+When you run `shellui add button`, that counts as **1 component**. Dependencies (button-variants, etc.) are auto-installed and **not** counted. Counts derived from `ComponentRegistry` where `IsAvailable = true`.
+
+| Category | Installable | Examples |
+|----------|-------------|----------|
+| Form | 17 | Button, Input, Select, Checkbox, Switch, Combobox, DatePicker, … |
+| Layout | 12 | Card, Sidebar, Navbar, Accordion, Resizable, DashboardLayout01/02, … |
+| Navigation | 7 | Tabs, Menubar, NavigationMenu, Pagination, Stepper, … |
+| Overlay | 8 | Dialog, Sheet, Drawer, Popover, Dropdown, Command, … |
+| Data Display | 13 | Table, DataTable, Badge, Avatar, Calendar, Carousel, Chart family, … |
+| Feedback | 9 | Alert, Callout, Toast, Sonner, Loading, Progress, Tooltip, … |
+| Utility | 2 | CopyButton, ThemeToggle |
+| **Total** | **68** | *Top-level components only; sub-components, variants, models, services excluded* |
 
 ## Project Structure
 
diff --git a/docs/CLI_SYNTAX.md b/docs/CLI_SYNTAX.md
@@ -179,7 +179,7 @@ Examples:
   dotnet shellui list --json
 ```
 
-**Output:** A table with columns: Component, Status (installed/available), Version, Category, Description. Run `dotnet shellui list` to see all ~100 available components.
+**Output:** A table with columns: Component, Status (installed/available), Version, Category, Description. Run `dotnet shellui list` to see all 68 installable components.
 
 ## update - Update Components
 
diff --git a/docs/COMPARISON.md b/docs/COMPARISON.md
@@ -9,7 +9,7 @@ A comprehensive comparison of ShellUI with other popular Blazor component librar
 | **Distribution** | CLI (Copy) | NuGet | NuGet | NuGet | NuGet | NuGet |
 | **Customization** | Full Source | Limited | Limited | Limited | Limited | Limited |
 | **CSS Framework** | Tailwind v4 | Custom | Bootstrap | Bootstrap/Custom | Ant Design | Custom |
-| **Component Count** | 100+ | 50+ | 90+ | 80+ | 60+ | 60+ |
+| **Component Count** | 68 | 50+ | 90+ | 80+ | 60+ | 60+ |
 | **Open Source** | Yes (MIT) | Yes (MIT) | Partial | Yes (MIT) | Yes (MIT) | Yes (MIT) |
 | **Commercial License** | Free | Free | Paid Plans | Free | Free | Free |
 | **Dark Mode** | Built-in | Built-in | Built-in | Built-in | Built-in | Built-in |
diff --git a/docs/COMPONENT_ROADMAP.md b/docs/COMPONENT_ROADMAP.md
@@ -2,29 +2,25 @@
 
 **Goal:** Build ALL components from shadcn/ui + extras needed for ShellDocs (Blazor fumadocs equivalent)
 
-## Current Status: 100 Installable Components - v0.3.0-alpha
+## Current Status: 68 Installable Components - v0.3.0-alpha
 
-### Completed (~100 install targets, dependencies auto-installed)
+### Completed (68 install targets; sub-components, variants, models, services auto-installed)
 
-**Form (11):** Button, Input, Textarea, Select, Checkbox, RadioGroup, RadioGroupItem, Switch, Toggle, Label, Slider
+Counts are top-level components users invoke directly via `shellui add <name>`. Anything that auto-installs as a dependency (e.g. `SidebarTrigger`, `DialogContent`, `ButtonVariants`, `SonnerService`) is not counted here.
 
-**Layout (19):** Card, CardHeader, CardTitle, CardDescription, CardContent, CardFooter, Tabs, TabsList, TabsTrigger, TabsContent, TabModels, Navbar, Sidebar, Separator, Accordion, AccordionItem, AccordionTrigger, AccordionContent, Breadcrumb, BreadcrumbItem, Collapsible, CollapsibleTrigger, CollapsibleContent, Resizable
+**Form (17):** Button, Checkbox, Combobox, DatePicker, DateRangePicker, FileUpload, Form, Input, InputOTP, Label, RadioGroup, Select, Slider, Switch, Textarea, TimePicker, Toggle
 
-**Navigation (8):** NavigationMenu, NavigationMenuItem, Menubar, MenubarItem, Dropdown, Pagination, ScrollArea, Sheet
+**Layout (12):** Accordion, Breadcrumb, Card, Collapsible, DashboardLayout01, DashboardLayout02, LinkCard, Navbar, Resizable, ScrollArea, Separator, Sidebar
 
-**Feedback (7):** Alert, AlertVariants, Progress, Skeleton, Toast, Loading, EmptyState
+**Navigation (7):** ContextMenu, Menubar, NavigationMenu, Pagination, PrevNextNav, Stepper, Tabs
 
-**Overlay (8):** Dialog, DialogTrigger, DialogContent, DialogHeader, DialogFooter, DialogTitle, DialogDescription, DialogClose, AlertDialog, Popover, Tooltip, HoverCard, Drawer, ContextMenu, Command
+**Overlay (8):** AlertDialog, Command, Dialog, Drawer, Dropdown, HoverCard, Popover, Sheet
 
-**Data Display (10):** Badge, BadgeVariants, Avatar, AvatarVariants, Table, TableHeader, TableBody, TableRow, TableHead, TableCell, DataTable
+**Data Display (13):** AreaChart, Avatar, Badge, BarChart, Calendar, Carousel, Chart, ChartSeries, DataTable, LineChart, MultiSeriesChart, PieChart, Table
 
-**Data Visualization (7):** Chart, BarChart, LineChart, AreaChart, PieChart, MultiSeriesChart, ChartSeries, ChartVariants
+**Feedback (9):** Alert, Callout, EmptyState, Loading, Progress, Skeleton, Sonner, Toast, Tooltip
 
-**Advanced (6):** Carousel, CarouselItem, CarouselContent, CarouselPrevious, CarouselNext, CarouselDots
-
-**Form Advanced (5):** Form, InputOTP, Combobox, DatePicker, DateRangePicker, TimePicker
-
-**Utility (3):** ThemeToggle, Shell, ButtonVariants, ToggleVariants, FileUpload, Stepper, StepperList, StepperStep, StepperContent, Calendar
+**Utility (2):** CopyButton, ThemeToggle
 
 ---
 
@@ -124,7 +120,7 @@ ShellDocs will need:
 
 - v0.1.0 (Dec 2025) - 73 components, CLI + NuGet
 - v0.1.1 (Dec 2025) - Hotfix, package publishing
-- **v0.3.0-alpha (Feb 2026) - Current alpha: Charts, 100 components, Tailwind 4.1.18**
+- **v0.3.0-alpha (Feb 2026) - Current alpha: Charts, 68 installable components, Tailwind 4.1.18**
 - v0.3.0 (Q1 2026) - ShellDocs components (CodeBlock, MDX, Callout, Steps, etc.)
 - v0.4.0 (Q2 2026) - ShellDocs site launch
 - v1.0.0 (Q2-Q3 2026) - .NET 10, stable API, comprehensive docs
diff --git a/docs/FAQ.md b/docs/FAQ.md
@@ -7,7 +7,7 @@ Quick answers to common questions about ShellUI.
 ### Q: What's the difference between NuGet package and CLI?
 
 **NuGet Package:**
-- **Contains:** ALL 100+ components in a compiled DLL
+- **Contains:** ALL 68 installable components in a compiled DLL
 - **Installation:** `dotnet add package ShellUI.Components`
 - **Format:** Compiled Razor Class Library (traditional)
 - **Usage:** Import and use immediately
@@ -31,7 +31,7 @@ Quick answers to common questions about ShellUI.
 **YES! This is actually recommended!**
 
 ```bash
-# 1. Install NuGet package (all 100+ components)
+# 1. Install NuGet package (all 68 components)
 dotnet add package ShellUI.Components
 
 # 2. Use NuGet components everywhere
diff --git a/docs/PROJECT_STATUS.md b/docs/PROJECT_STATUS.md
@@ -4,8 +4,8 @@
 
 **ShellUI alpha is available on NuGet!** Test before upgrading to stable.
 
-- ✅ **Version 0.3.0-alpha.2** - 100 installable components (actual components only; dependencies auto-installed)
-- ✅ **100 Production-Ready Components** - Fully functional and tested
+- ✅ **Version 0.3.0-alpha.3** - 68 installable components (top-level only; sub-components, variants, models, services auto-installed)
+- ✅ **68 Production-Ready Components** - Fully functional and tested
 - ✅ **CLI Tool Published** - `dotnet tool install -g ShellUI.CLI`
 - ✅ **NuGet Packages Published** - `ShellUI.Components`, `ShellUI.CLI`, `ShellUI.Templates`
 - ✅ **Hybrid Distribution** - CLI + NuGet packages (best of both worlds!)
@@ -18,17 +18,21 @@
 - [x] CLI Tool (`ShellUI.CLI`) - Published to NuGet
 - [x] Components Package (`ShellUI.Components`) - Published to NuGet
 - [x] Templates Package (`ShellUI.Templates`) - Embedded in CLI
-- [x] Component Registry - 139 templates (~100 installable)
+- [x] Component Registry - 167 templates (68 installable; rest are sub-components/variants/models/services that auto-install)
 - [x] Tailwind CSS Integration - v4.1.18 standalone CLI support
 - [x] MSBuild Integration - Automatic CSS compilation
 
-### Components (100 Installable)
-- [x] **Form Components (14)**: Button, Input, Textarea, Select, Checkbox, RadioGroup, RadioGroupItem, Switch, Toggle, Label, Slider, Form, InputOTP, Combobox
-- [x] **Layout Components (15)**: Card, Dialog, Sheet, Drawer, Popover, Tooltip, Separator, ScrollArea, Resizable, Collapsible, Accordion, Sonner, Toast
-- [x] **Navigation Components (12)**: Navbar, Sidebar, NavigationMenu, Menubar, MenubarItem, Pagination, Tabs, Stepper, Breadcrumb, BreadcrumbItem
-- [x] **Data Display (14)**: Table, DataTable, Badge, Avatar, Alert, Toast, Sonner, Skeleton, Progress, Loading
-- [x] **Interactive Components (8)**: Dropdown, Command, ContextMenu, HoverCard, ThemeToggle, EmptyState, FileUpload, CopyButton
-- [x] **Advanced Components (18+)**: Calendar, DatePicker, DateRangePicker, TimePicker, AlertDialog, Carousel, Charts (Chart, BarChart, LineChart, PieChart, AreaChart, MultiSeriesChart)
+### Components (68 Installable)
+
+Counts are top-level components users invoke directly via `shellui add <name>`. Anything that auto-installs as a dependency (e.g. `SidebarTrigger`, `DialogContent`, `ButtonVariants`, `SonnerService`) is not counted.
+
+- [x] **Form (17)**: Button, Checkbox, Combobox, DatePicker, DateRangePicker, FileUpload, Form, Input, InputOTP, Label, RadioGroup, Select, Slider, Switch, Textarea, TimePicker, Toggle
+- [x] **Layout (12)**: Accordion, Breadcrumb, Card, Collapsible, DashboardLayout01, DashboardLayout02, LinkCard, Navbar, Resizable, ScrollArea, Separator, Sidebar
+- [x] **Navigation (7)**: ContextMenu, Menubar, NavigationMenu, Pagination, PrevNextNav, Stepper, Tabs
+- [x] **Overlay (8)**: AlertDialog, Command, Dialog, Drawer, Dropdown, HoverCard, Popover, Sheet
+- [x] **Data Display (13)**: AreaChart, Avatar, Badge, BarChart, Calendar, Carousel, Chart, ChartSeries, DataTable, LineChart, MultiSeriesChart, PieChart, Table
+- [x] **Feedback (9)**: Alert, Callout, EmptyState, Loading, Progress, Skeleton, Sonner, Toast, Tooltip
+- [x] **Utility (2)**: CopyButton, ThemeToggle
 
 ### Documentation
 - [x] README.md - Project overview and quick start
@@ -73,7 +77,7 @@
 
 | Milestone | Status |
 |-----------|--------|
-| v0.3.0-alpha - 100 components, CLI, NuGet | ✅ Done |
+| v0.3.0-alpha - 68 installable components, CLI, NuGet | ✅ Done |
 | Tailwind v4.1.18 standalone | ✅ Done |
 | Alpha testing & validation | 🔄 In progress |
 | v0.3.0 stable (after testing) | 🎯 Next |
@@ -169,12 +173,12 @@ dotnet shellui add button input card
 - [x] CLI tool published to NuGet
 - [x] NuGet packages published (Components, CLI, Templates)
 - [x] Can initialize projects (no Node.js!)
-- [x] 100 components working (both CLI and NuGet)
+- [x] 68 installable components working (both CLI and NuGet)
 - [x] Basic documentation live
 - [ ] 50+ GitHub stars (in progress)
 
 ### Beta Success (Q2 2026)
-- [x] 100+ components available
+- [x] 68 installable components available
 - [ ] Component registry operational
 - [ ] Hybrid workflow proven
 - [ ] 500+ GitHub stars
diff --git a/docs/QUICKSTART.md b/docs/QUICKSTART.md
@@ -1,6 +1,6 @@
 # ShellUI Quick Start Guide
 
-**Note:** ShellUI is in alpha with 100 components. Test and provide feedback!
+**Note:** ShellUI is in alpha with 68 installable components. Test and provide feedback!
 
 ## What is ShellUI?
 
@@ -164,7 +164,7 @@ Then use it:
 dotnet shellui list
 ```
 
-Output: A table showing component name, status (installed/available), version, category, and description. Run `dotnet shellui list` to see all ~100 components.
+Output: A table showing component name, status (installed/available), version, category, and description. Run `dotnet shellui list` to see all 68 installable components.
 
 ### List only installed components
 
diff --git a/src/ShellUI.CLI/README.md b/src/ShellUI.CLI/README.md
@@ -110,7 +110,7 @@ dotnet shellui add dashboard-01   # or dashboard-02
 ### Data Display
 - `table`, `data-table`, `badge`, `avatar`, `alert`, `toast`, `sonner`, `skeleton`, `progress`, `loading`
 
-**~100 components total** (run `dotnet shellui list` for full list; dependencies auto-installed)
+**68 installable components total** (run `dotnet shellui list` for full list; sub-components, variants, models, and services auto-install as dependencies)
 
 ### Interactive Components
 - `dropdown`, `accordion`, `toggle`, `theme-toggle`, `command`, `context-menu`, `hover-card`
diff --git a/src/ShellUI.Components/README.md b/src/ShellUI.Components/README.md
@@ -4,7 +4,7 @@ Beautiful, accessible Blazor components inspired by shadcn/ui. A CLI-first compo
 
 ## Features
 
-- 🎨 **100 Production-ready components** - Button, Input, Card, Dialog, Sonner, Table, Charts, and more
+- 🎨 **68 Production-ready installable components** - Button, Input, Card, Dialog, Sonner, Table, Charts, and more (sub-components and variants ship as auto-installed dependencies)
 - 🎯 **CLI-first approach** - Install components individually with `dotnet shellui add`
 - 🎨 **Tailwind CSS styling** - Utility-first CSS with dark mode support
 - ♿ **Accessible by default** - Built with accessibility in mind
diff --git a/src/ShellUI.Templates/README.md b/src/ShellUI.Templates/README.md
@@ -29,7 +29,7 @@ dotnet shellui add card dialog
 ## What's Included
 
 This package contains:
-- **~100 Installable Component Templates** - Primary components (dependencies like *-variants auto-installed)
+- **68 Installable Component Templates** - Top-level components (167 templates total; sub-components, variants, models, services auto-install as dependencies)
 - **Metadata** - Component metadata including dependencies, categories, and descriptions
 - **Registry** - Component registry for CLI discovery
 
