Skip to content

Commit 7f3c32d

Browse files
committed
updates
1 parent 63eb9b6 commit 7f3c32d

File tree

6 files changed

+260
-94
lines changed

6 files changed

+260
-94
lines changed

app/(home)/page.tsx

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,9 @@ export default function HomePage() {
3535
{/* Spinning React Logo Watermark (Positioned absolutely to the right) */}
3636
<svg className="absolute -right-20 top-20 h-[600px] w-[600px] text-cyan-500/5 animate-[spin_60s_linear_infinite] pointer-events-none" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="0.5">
3737
<circle cx="12" cy="12" r="2"></circle>
38-
<ellipse rx="10" ry="4.5" transform="rotate(60 12 12)"></ellipse>
39-
<ellipse rx="10" ry="4.5" transform="rotate(120 12 12)"></ellipse>
40-
<ellipse rx="10" ry="4.5"></ellipse>
38+
<ellipse cx="12" cy="12" rx="10" ry="4.5" transform="rotate(60 12 12)"></ellipse>
39+
<ellipse cx="12" cy="12" rx="10" ry="4.5" transform="rotate(120 12 12)"></ellipse>
40+
<ellipse cx="12" cy="12" rx="10" ry="4.5"></ellipse>
4141
</svg>
4242

4343
{/* 2. Main Content Container */}
@@ -74,7 +74,7 @@ export default function HomePage() {
7474
<svg className="w-5 h-5 ml-2 -mr-1 transition-transform group-hover:translate-x-1" fill="none" stroke="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M13 7l5 5m0 0l-5 5m5-5H6"></path></svg>
7575
</Link>
7676
<Link
77-
href="/docs/templates"
77+
href="/docs/templates/react-static"
7878
className="inline-flex items-center justify-center px-8 py-4 text-lg font-bold text-white transition-all duration-200 bg-transparent border-2 border-slate-600 hover:border-cyan-400/50 rounded-full hover:bg-slate-800 hover:text-cyan-300 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-slate-600 shadow-sm"
7979
>
8080
Explore Templates
@@ -329,11 +329,11 @@ export default function HomePage() {
329329
<div className="absolute inset-0 opacity-20 pointer-events-none">
330330
<svg className="h-full w-full" aria-hidden="true">
331331
<defs>
332-
<pattern id="featured-grid" width="40" height="40" patternUnits="userSpaceOnUse">
332+
<pattern id="gallery-grid" width="40" height="40" patternUnits="userSpaceOnUse">
333333
<path d="M0 40L40 0H20L0 20M40 40V20L20 40" stroke="#0ea5e9" strokeWidth="1" fill="none" opacity="0.1" />
334334
</pattern>
335335
</defs>
336-
<rect width="100%" height="100%" fill="url(#featured-grid)" />
336+
<rect width="100%" height="100%" fill="url(#gallery-grid)" />
337337
</svg>
338338
</div>
339339

components/templates.tsx

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
1+
'use client';
12
import { cn } from 'fumadocs-ui/utils/cn';
23
import React, { useState, useMemo } from 'react';
34

@@ -91,8 +92,8 @@ export default function TemplateSelector({ templates, hide, className }: Templat
9192
templates.length === 1
9293
? 'grid-cols-1'
9394
: templates.length === 2
94-
? 'grid-cols-2 max-w-md mx-auto'
95-
: 'grid-cols-3';
95+
? 'grid-cols-1 sm:grid-cols-2 max-w-md mx-auto'
96+
: 'grid-cols-1 sm:grid-cols-3';
9697

9798
return (
9899
<div className={cn('not-prose', className)}>

content/docs/benefits.mdx

Lines changed: 235 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,235 @@
1+
---
2+
title: Benefits
3+
description: Why React + .NET is the optimal stack for AI-assisted development
4+
---
5+
6+
# Why React Over Blazor for AI-Generated UIs
7+
8+
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
9+
[Replit](https://blog.replit.com/react),
10+
[Lovable](https://lovable.dev/blog/best-tailwind-css-component),
11+
[Google's AI Studio](https://aistudio.google.com),
12+
[Vercel's v0](https://v0.app) and [Claude Code Web](https://claude.ai/code)
13+
14+
## AI Models Are Better at React
15+
16+
Large Language Models have been trained on vastly more React code than Blazor. The numbers tell the story:
17+
18+
- **React**: Millions of open-source projects, decades of Stack Overflow answers, comprehensive documentation
19+
- **Blazor**: A fraction of the training data, newer ecosystem, limited real-world examples
20+
21+
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.
22+
23+
## Revolutionary Productivity Gains
24+
25+
AI-assisted development with React delivers transformative productivity:
26+
27+
- **Instant UI Generation**: Describe what you want, get working React components first time
28+
- **Tailwind CSS Fluency**: AI excels at generating Tailwind's encapsulated utility-first CSS that just works
29+
- **TypeScript Integration**: Produces type-safe code, gives AI important context & catches errors at compile time
30+
- **Component Composition**: AI understands React's composable design and generates modular, reusable code
31+
32+
This isn't incremental improvement - it's a paradigm shift. Features that took days now take minutes.
33+
34+
## Instant Feedback with Hot Module Reload
35+
36+
In AI-first development, **iteration speed is everything**. You prompt, generate, review, refine and repeat. React's Hot Module Reload (HMR) delivers:
37+
38+
- **Sub-second Updates**: Changes appear instantly without losing component state
39+
- **Reliable Reloads**: Vite's HMR just works, every time
40+
- **CSS Hot Swapping**: Tailwind changes reflect immediately
41+
- **Error Recovery**: Fix errors and continue without restarting
42+
43+
Blazor's reload experience is a different story:
44+
45+
- **Full Page Reloads**: Most changes require complete page refreshes
46+
- **Slow Compilation**: C# compilation adds seconds to every iteration
47+
- **State Loss**: Component state is lost on reload
48+
- **Unreliable Hot Reload**: Blazor's hot reload frequently fails, requiring manual refresh or restart
49+
50+
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.
51+
52+
## The Industry Has Chosen React
53+
54+
The world's most demanding applications run on React.
55+
56+
### The React Ecosystem
57+
58+
The numbers speak for themselves:
59+
60+
- **Meta, Netflix, Airbnb, Discord, Shopify**—all React
61+
- **20+ million weekly npm downloads** of React
62+
- **Thousands of production-ready component libraries**
63+
- **Decade of battle-tested patterns and best practices**
64+
65+
When you choose React, you're joining the largest, most active frontend ecosystem in the world.
66+
67+
### Microsoft Bets on React
68+
69+
Even Microsoft relies on React for their most important web properties:
70+
71+
- **Microsoft Teams**: 250+ million users on React
72+
- **Azure Portal**: Enterprise cloud management built on React
73+
- **Outlook Web**: Microsoft's flagship email client
74+
- **Visual Studio Code (Web)**: The world's most popular editor
75+
- **Microsoft 365**: Office apps in the browser
76+
77+
78+
## The Blazor Trade-off
79+
80+
Blazor's promise of "C# everywhere" comes with significant costs:
81+
82+
- **Larger Bundle Sizes**: WebAssembly runtime adds 2-5MB of overhead
83+
- **Limited AI Training Data**: Models struggle with Blazor-specific patterns
84+
- **Smaller Ecosystem**: Fewer libraries, components, and community solutions
85+
- **Performance Concerns**: DOM interop through JavaScript adds latency
86+
- **Slow Iteration**: Compilation overhead kills AI-assisted development flow
87+
88+
React's battle-tested ecosystem, instant iteration, and AI fluency make it the pragmatic choice for teams building modern applications.
89+
90+
---
91+
92+
# Industrial-Strength .NET Backend
93+
94+
While React handles the UI, your backend needs enterprise-grade capabilities. ServiceStack on .NET delivers:
95+
96+
## Performance & Scalability
97+
98+
.NET consistently ranks among the fastest web frameworks in [TechEmpower benchmarks](https://www.techempower.com/benchmarks/). ServiceStack adds:
99+
100+
- **Async-first Architecture**: Non-blocking I/O for maximum throughput
101+
- **Connection Pooling**: Efficient database resource utilization
102+
- **Built-in Caching**: Redis, Memory, and hybrid caching strategies
103+
- **Horizontal Scaling**: Stateless design enables easy scaling
104+
105+
## Robustness & Reliability
106+
107+
Production systems demand reliability:
108+
109+
- **Strong Typing**: Catch errors at compile time, not runtime
110+
- **Comprehensive Validation**: Fluent Validation integrated at the core
111+
- **Structured Error Handling**: Consistent error responses across all APIs
112+
- **Audit Logging**: Track every change with built-in audit trails
113+
114+
## Concurrency & Threading
115+
116+
.NET's threading model is designed for high-concurrency scenarios:
117+
118+
- **async/await**: First-class asynchronous programming
119+
- **Thread Pool Optimization**: Automatic thread management
120+
- **Cancellation Support**: Graceful request cancellation
121+
- **Background Jobs**: Durable job processing with monitoring
122+
123+
---
124+
125+
# Tightly Integrated React Components
126+
127+
The `@servicestack/react` library provides pre-built components that understand your ServiceStack APIs.
128+
129+
## API-Bound Forms with Validation
130+
131+
Create forms that automatically bind to your APIs with full validation:
132+
133+
```tsx
134+
<AutoForm type={CreateBooking} onSuccess={handleSuccess} />
135+
```
136+
137+
This single line generates a complete form with:
138+
- Input fields for every DTO property
139+
- Client-side validation from your Fluent Validation rules
140+
- Server-side error binding
141+
- Loading states and error handling
142+
- Accessible, styled components
143+
144+
## Full CRUD UIs in One Line
145+
146+
The [AutoQueryGrid](https://react.servicestack.net/gallery/autoquerygrid) component generates complete data management interfaces:
147+
148+
```tsx
149+
<AutoQueryGrid type={QueryBookings} />
150+
```
151+
152+
You get:
153+
- Sortable, filterable data grid
154+
- Pagination with configurable page sizes
155+
- Create, Read, Update, Delete operations
156+
- Inline editing with validation
157+
- Export to CSV/Excel
158+
- Responsive design
159+
160+
## Zero Boilerplate Integration
161+
162+
Every API call is type-safe and consistent:
163+
164+
```tsx
165+
const client = new JsonServiceClient()
166+
const api = await client.api(new QueryBookings({ nameContains: "Smith" }))
167+
168+
if (api.succeeded) {
169+
setBookings(api.response.results)
170+
} else {
171+
setError(api.error)
172+
}
173+
```
174+
175+
No more guessing API shapes, no more runtime type errors, no more manual serialization.
176+
177+
---
178+
179+
# Maximum Connectivity with ServiceStack
180+
181+
ServiceStack isn't just another .NET framework—it's a connectivity platform that speaks every language.
182+
183+
## Native End-to-End Typed Support for 11 Languages
184+
185+
[Add ServiceStack Reference](https://docs.servicestack.net/add-servicestack-reference) generates native typed DTOs for:
186+
187+
| Language | Client Library | Generate DTO Command |
188+
|------------|----------------|----------------------|
189+
| TypeScript | [@servicestack/client](https://www.npmjs.com/package/@servicestack/client) | `npx get-dtos typescript` |
190+
| JavaScript | [@servicestack/client](https://www.npmjs.com/package/@servicestack/client) | `npx get-dtos mjs` |
191+
| C# | [ServiceStack.Client](http://nuget.org/packages/ServiceStack.Client) | `npx get-dtos csharp` |
192+
| Java | [net.servicestack:client](https://docs.servicestack.net/java-add-servicestack-reference) | `npx get-dtos java` |
193+
| Kotlin | [net.servicestack:client](https://docs.servicestack.net/java-add-servicestack-reference) | `npx get-dtos kotlin` |
194+
| Swift | [ServiceStack.Swift](https://github.com/ServiceStack/ServiceStack.Swift) | `npx get-dtos swift` |
195+
| Dart | [servicestack](https://pub.dev/packages/servicestack) | `npx get-dtos dart` |
196+
| Python | [servicestack](https://pypi.org/project/servicestack) | `npx get-dtos python` |
197+
| PHP | [servicestack/client](https://packagist.org/packages/servicestack/client) | `npx get-dtos php` |
198+
| F# | [ServiceStack.Client](http://nuget.org/packages/ServiceStack.Client) | `npx get-dtos fsharp` |
199+
| VB.NET | [ServiceStack.Client](http://nuget.org/packages/ServiceStack.Client) | `npx get-dtos vbnet` |
200+
201+
One API definition, 11 typed clients - all generated automatically.
202+
203+
## Every Data Format You Need
204+
205+
ServiceStack supports multiple wire formats out of the box:
206+
207+
- **JSON** - Default, optimized serialization
208+
- **CSV** - Perfect for data exports and spreadsheet integration
209+
- **XML** - Enterprise system compatibility
210+
- **JSV** - Compact, human-readable format
211+
- **Protocol Buffers** - Binary efficiency for gRPC
212+
- **MessagePack** - Fast binary serialization
213+
- **HTML** - Server-rendered responses
214+
215+
## gRPC for Maximum Performance
216+
217+
When JSON isn't fast enough, ServiceStack's [gRPC support](https://docs.servicestack.net/grpc) provides:
218+
219+
- **Binary Protocol**: Smaller payloads, faster parsing
220+
- **HTTP/2**: Multiplexed connections, header compression
221+
- **Streaming**: Bi-directional real-time communication
222+
- **Code Generation**: Typed clients from `.proto` definitions
223+
224+
---
225+
226+
# The Vibe Stack Advantage
227+
228+
The combination of AI-fluent React frontend and industrial-strength ServiceStack backend creates a development experience unlike any other:
229+
230+
- **AI generates UIs** with unprecedented accuracy
231+
- **.NET handles the heavy lifting** with enterprise-grade reliability
232+
- **ServiceStack connects everything** with typed APIs for any client
233+
- **One team, one codebase** delivers full-stack applications faster than ever
234+
235+
This is the future of software development. Start building with the Vibe Stack today.

content/docs/features.mdx

Lines changed: 0 additions & 63 deletions
This file was deleted.

0 commit comments

Comments
 (0)