updates

Author: mythz

content/docs/benefits.mdx

@@ -5,7 +5,7 @@ description: Why React + .NET is the optimal stack for AI-assisted development
 
 # Why React Over Blazor for AI-Generated UIs
 
-The future of software development is AI-assisted, and the choice of frontend technology has never been more consequential. While Blazor offers a familiar C# experience for .NET developers, **React is the clear winner for AI-generated user interfaces** where it's the de facto standard for AI-generated Apps from 
+The future of software development is AI-assisted, and the choice of frontend technology has never been more consequential. While Blazor offers a familiar C# experience for .NET developers, **React is the clear winner for AI-generated user interfaces** where it's the de facto standard for instant AI-generated Apps from 
 [Replit](https://blog.replit.com/react),
 [Lovable](https://lovable.dev/blog/best-tailwind-css-component),
 [Google's AI Studio](https://aistudio.google.com),
@@ -18,7 +18,7 @@ Large Language Models have been trained on vastly more React code than Blazor. T
 - **React**: Millions of open-source projects, decades of Stack Overflow answers, comprehensive documentation
 - **Blazor**: A fraction of the training data, newer ecosystem, limited real-world examples
 
-When you ask AI to generate a complex UI component, form, or data visualization, React code is generated with higher accuracy, better patterns, and fewer errors. AI models much larger training set understand React's component model, hooks, and ecosystem libraries at a deep level.
+When you ask AI to generate a complex UI component, form, or data visualization, React code is generated with higher accuracy, better patterns, and fewer errors. React's much larger training set results in AI models understanding React's component model, hooks, and ecosystem libraries at a much deeper level.
 
 ## Revolutionary Productivity Gains
 
@@ -27,9 +27,9 @@ AI-assisted development with React delivers transformative productivity:
 - **Instant UI Generation**: Describe what you want, get working React components first time
 - **Tailwind CSS Fluency**: AI excels at generating Tailwind's encapsulated utility-first CSS that just works
 - **TypeScript Integration**: Produces type-safe code, gives AI important context & catches errors at compile time
-- **Component Composition**: AI understands React's composable design and generates modular, reusable code
+- **Component Composition**: AI understands React's composable design to generate modular, reusable code
 
-This isn't incremental improvement - it's a paradigm shift. Features that took days now take minutes.
+This isn't incremental improvement - it's a paradigm shift. Features that took days now takes minutes.
 
 ## Instant Feedback with Hot Module Reload
 
@@ -42,12 +42,12 @@ In AI-first development, **iteration speed is everything**. You prompt, generate
 
 Blazor's reload experience is a different story:
 
-- **Full Page Reloads**: Most changes require complete page refreshes
+- **Full Page Reloads**: Many changes require complete page refreshes or full app restarts
 - **Slow Compilation**: C# compilation adds seconds to every iteration
-- **State Loss**: Component state is lost on reload
+- **State Loss**: Component state lost on reload
 - **Unreliable Hot Reload**: Blazor's hot reload frequently fails, requiring manual refresh or restart
 
-When you're iterating with AI, waiting 5-10 seconds per change versus instant feedback compounds dramatically. Over a development session, React developers complete **far more iteration cycles** - and iteration is vital for producing accurate, requirements conforming, high quality, polished results.
+When you're iterating with AI, waiting 5-10 seconds per change versus instant feedback compounds dramatically. Over a development session, React developers complete **far more iteration cycles** - iteration that is vital for producing accurate, requirements conforming, high quality, polished results.
 
 ## The Industry Has Chosen React
 
@@ -57,8 +57,8 @@ The world's most demanding applications run on React.
 
 The numbers speak for themselves:
 
-- **Meta, Netflix, Airbnb, Discord, Shopify**—all React
-- **20+ million weekly npm downloads** of React
+- **Meta, Netflix, Airbnb, Discord, Shopify** - all React
+- **50 million weekly npm downloads** of React
 - **Thousands of production-ready component libraries**
 - **Decade of battle-tested patterns and best practices**
 
@@ -93,6 +93,15 @@ React's battle-tested ecosystem, instant iteration, and AI fluency make it the p
 
 While React handles the UI, your backend needs enterprise-grade capabilities. ServiceStack on .NET delivers:
 
+## Robustness & Reliability
+
+Production systems demand reliability:
+
+- **Strong Typing**: Catch errors at compile time, not runtime
+- **Comprehensive Validation**: Fluent & Declarative Validation integrated at the core
+- **Structured Error Handling**: Consistent error responses across all APIs
+- **Audit Logging**: Track every AutoQuery CRUD change with built-in audit trails
+
 ## Performance & Scalability
 
 .NET consistently ranks among the fastest web frameworks in [TechEmpower benchmarks](https://www.techempower.com/benchmarks/). ServiceStack adds:
@@ -102,15 +111,6 @@ While React handles the UI, your backend needs enterprise-grade capabilities. Se
 - **Built-in Caching**: Redis, Memory, and hybrid caching strategies
 - **Horizontal Scaling**: Stateless design enables easy scaling
 
-## Robustness & Reliability
-
-Production systems demand reliability:
-
-- **Strong Typing**: Catch errors at compile time, not runtime
-- **Comprehensive Validation**: Fluent Validation integrated at the core
-- **Structured Error Handling**: Consistent error responses across all APIs
-- **Audit Logging**: Track every change with built-in audit trails
-
 ## Concurrency & Threading
 
 .NET's threading model is designed for high-concurrency scenarios:
@@ -220,16 +220,3 @@ When JSON isn't fast enough, ServiceStack's [gRPC support](https://docs.services
 - **HTTP/2**: Multiplexed connections, header compression
 - **Streaming**: Bi-directional real-time communication
 - **Code Generation**: Typed clients from `.proto` definitions
-
----
-
-# The Vibe Stack Advantage
-
-The combination of AI-fluent React frontend and industrial-strength ServiceStack backend creates a development experience unlike any other:
-
-- **AI generates UIs** with unprecedented accuracy
-- **.NET handles the heavy lifting** with enterprise-grade reliability
-- **ServiceStack connects everything** with typed APIs for any client
-- **One team, one codebase** delivers full-stack applications faster than ever
-
-This is the future of software development. Start building with the Vibe Stack today.

content/docs/templates/index.mdx

@@ -1,8 +1,19 @@
 ---
 title: Minimal Templates
-description: Common features for all templates
+description: Ultimate .NET React Templates for Vibe Coded UIs running on robust and scalable .NET backends.
 ---
 
+# The Vibe Stack Advantage
+
+The combination of AI-fluent React frontend and industrial-strength ServiceStack backend creates a development experience unlike any other:
+
+- **AI generates UIs** with unprecedented accuracy
+- **.NET handles the heavy lifting** with enterprise-grade reliability
+- **ServiceStack connects everything** with typed APIs for any client
+- **One team, one codebase** delivers full-stack applications faster than ever
+
+This is the future of software development. Unlock unprecedented productivity with Vibe Stack ready templates.
+
 ## Core Technologies
 
 ### Frontend (Next.js 16 + React 19)

content/docs/templates/nextjs.mdx

@@ -3,6 +3,8 @@ title: Next.js App
 description: Full-featured Next.js Static Export Identity Auth Template
 ---
 
+These full-featured templates serve as reference implementations for how to implement popular features and integrate them within .NET React Templates.
+
 # .NET 10 Full-featured Next.js Static Export Template
 
 import TemplateIntro from '@/components/template-intro';

content/docs/templates/react-spa.mdx

@@ -3,6 +3,8 @@ title: React SPA
 description: Full-featured Vite React SPA with .NET 10 Identity Auth Template
 ---
 
+These full-featured templates serve as reference implementations for how to implement popular features and integrate them within .NET React Templates.
+
 # .NET 10 Full-featured Vite React SPA Template
 
 import TemplateIntro from '@/components/template-intro';