Pasquale/cui 96 move shadcnradix instructions to a separate page (#603)

* docs: updates

* docs: update migration guide and command component documentation for clarity and key differences

* docs: mc

Author: pasqualevitiello

apps/ui/content/docs/(root)/index.mdx

@@ -7,7 +7,7 @@ description: A new, modern UI component library built on top of Base UI. Built f
 
 We think Base UI is the best foundation for modern web applications. We've taken its powerful, unstyled primitives and given them a design system that's ready to go, right out of the box.
 
-This is the component library we'll be progressively adopting for [cal.com](https://cal.com). We're building it in the open for anyone who wants to create beautiful, reliable user interfaces.
+This is the component library we'll be progressively adopting for [Cal.com](https://cal.com). We're building it in the open for anyone who wants to create beautiful, reliable user interfaces.
 
 <Alert className="bg-muted/24">
   <InfoIcon />
@@ -31,13 +31,18 @@ Instead of installing a package, you get the source code. This means:
 - **Endless customization:** Need to change something? Just edit the file.
 - **Learn by doing:** See how components are built and adapt them to your needs.
 
-## Like shadcn/ui, but with Base UI
+## Built on Base UI, Designed for Production
 
-If you've used shadcn/ui, you'll feel right at home. The main difference is the foundation: **shadcn/ui uses Radix UI**, while **coss ui uses Base UI**.
+coss ui is built on **Base UI** from the ground up—not as an adaptation or port from Radix UI. We chose Base UI for its robust, accessible, and unopinionated primitives that handle the hard parts (accessibility, keyboard navigation, focus management) without imposing design decisions.
 
-We chose Base UI for its robust, accessible, and unopinionated primitives. It handles the hard parts—like accessibility, keyboard navigation, and focus management—without imposing any styles. This gives us the freedom to create a design system that is both beautiful and flexible, and it gives you a solid foundation to build upon.
+While shadcn/ui is now available with Base UI, coss ui isn't about re-implementing shadcn. It's about creating a **coherent, opinionated UI system tailored to real production applications** like [Cal.com](https://cal.com) and [coss.com](https://coss.com). Our components, patterns, and evolutions go beyond base primitives, incorporating:
 
-If you're considering a move from a Radix-based library, we provide a clear migration path. Each of our components comes with detailed comparing with Radix / shadcn to make the transition as smooth as possible.
+- **Production-tested patterns** from real-world applications
+- **Extended component variants** for common use cases
+- **Thoughtful defaults** optimized for modern, dense UIs
+- **Consistent design system** across all components
+
+If you're migrating from shadcn/ui or Radix UI, we provide a comprehensive [migration guide](/ui/docs/radix-shadcn-migration) to make the transition smooth.
 
 ## Primitives, Particles and Atoms
 

apps/ui/content/docs/(root)/meta.json

@@ -1,4 +1,10 @@
 {
-  "pages": ["index", "get-started", "styling", "roadmap"],
+  "pages": [
+    "index",
+    "get-started",
+    "styling",
+    "radix-shadcn-migration",
+    "roadmap"
+  ],
   "title": "Overview"
 }