Add React docs

Author: mythz

MyApp/_pages/react/install.md

@@ -0,0 +1,285 @@
+---
+title: .NET React Templates
+---
+
+## First-Class React + Tailwind for AI-First Development
+
+We're witnessing a fundamental shift in how applications are built. AI code generation has evolved from a novelty to a productivity multiplier that's become too significant to ignore. While AI models still require oversight for production backend systems, they excel at generating frontend UIs—compressing development timelines that once took months into days.
+
+## The Rise of Vibe Coding
+
+AI can now generate complete, production-ready UI code. This enables an entirely new development workflow that [Andrej Karpathy](https://en.wikipedia.org/wiki/Andrej_Karpathy) has termed ["Vibe Coding"](https://en.wikipedia.org/wiki/Vibe_coding)—where developers iteratively guide AI agents to implement features through natural language instructions, where features can be iteratively prototyped, refined and improved within seconds instead of hours.
+
+This AI-first approach is rapidly maturing, with tools like [Cursor](https://cursor.com), [Claude Code](https://www.claude.com/product/claude-code), and [Codex](https://chatgpt.com/features/codex/) becoming the preferred platforms for this new paradigm with new tools designed to get maximum effectiveness of AI models with sophisticated planning
+tools, focused models optimized for code generation and edits and agentic workflows that's able to solidifying each new feature iteration with tests, along with detailed documentation, planning, migrations and usage guides.
+
+## React & Tailwind: The AI Development Standard
+
+React and Tailwind have emerged as the de facto standards for AI-generated UIs. Every major platform for generating applications from prompts has converged on this stack including
+[Replit](https://blog.replit.com/react),
+[Lovable](https://lovable.dev/blog/best-tailwind-css-component),
+[Google's AI Studio](https://aistudio.google.com),
+[Vercel's v0](https://v0.app) and [Claude Code Web](https://claude.ai/code).
+
+### TypeScript
+
+Whilst TypeScript is often excluded in one-prompt solutions catering to non-developers, it's still a critical part of the AI development workflow. It provides a type system that helps AI models generate more accurate and maintainable code and TypeScript's static analysis also helps identify errors in the generated code which AI Models have have become really good at correcting—as such it's an integral part in all our React templates.
+
+## How ServiceStack Excels in AI-First Development
+
+Context is king when developing with AI models. The better the context, the higher the quality of generated code
+and ServiceStack's architecture is uniquely suited for AI-assisted development:
+
+### Declarative Typed APIs
+
+All ServiceStack APIs follow a flat, declarative structure—The contract is explicit and consistent and LLMs don't need to guess what APIs accept or return.
+
+### End-to-End Type Safety
+
+Context quality directly impacts generated code quality. ServiceStack's TypeScript integration provides complete static analysis of what APIs accept, return, and how to bind responses—giving AI models the full context they need.
+The static analysis feedback also directs models to identify and correct any errors in the generated code.
+
+### Zero-Ambiguity Integration
+
+AI models thrive on consistency. ServiceStack removes guesswork with a single pattern for all API calls:
+- One generic `JsonServiceClient` for all APIs
+- Consistent methods used to send all requests
+- Consistent Typed Request DTO → Response DTO flow
+- Uniform error handling
+
+### Intuitive Project Structure
+
+ServiceStack's [physical project structure](/physical-project-structure) provides clear separation of concerns, with the entire API surface area contained in [the ServiceModel project](/physical-project-structure#servicemodel-project)—making codebases easy for AI models to navigate and understand.
+
+### Minimal Code Surface
+
+Less code means fewer opportunities for errors. ServiceStack's high-productivity features minimize the code AI needs to generate:
+
+- **[AutoQuery APIs](/autoquery/)** - Flexible, queryable APIs defined with just a Request DTO
+- **[AutoQueryGrid Component](https://react.servicestack.net/gallery/autoquerygrid)** - Complete CRUD UIs in 1 line of code
+- **[Auto Form Components](https://react.servicestack.net/gallery/autoform)** - Beautiful, validation-bound forms in 1 line of code
+
+These components are ideal for rapidly building backend management interfaces, freeing developers to focus on differentiating customer-facing features.
+
+
+## Modern React Project Templates
+
+We're introducing three production-ready React templates, each optimized for different use cases:
+
+
+<react-template 
+  name="react-vite" 
+  description="A lightweight foundation built with React + Vite + TypeScript + Tailwind CSS—the ideal blank slate starting point for AI-generated UIs."></react-template>
+
+<react-template 
+  name="react-spa" 
+  description="A comprehensive single-page application with deep ServiceStack integration and ASP.NET Core Identity Auth, perfect for full-featured web applications."></react-template>
+
+<react-template 
+  name="nextjs" 
+  description="A Next.js template with TypeScript and Tailwind CSS, offering server-side rendering and optimized performance with complete ServiceStack integration."></react-template>
+
+
+## Comprehensive React Component Library
+
+All three templates leverage our new [React Component Gallery](https://react.servicestack.net)—a high-fidelity port of our proven [Vue Component Library](/vue/) and [Blazor Component Library](https://blazor.servicestack.net). This comprehensive collection provides everything needed to build highly productive, modern and responsive web applications.
+
+:::{.not-prose}
+:::{.my-8 .max-w-3xl .mx-auto .rounded-lg .overflow-hidden .shadow .hover:shadow-xl}
+[![](/img/pages/react/react-gallery.webp)](https://react.servicestack.net)
+:::
+:::
+
+Switch to Dark Mode to see how all components looks in Dark Mode:
+
+:::{.not-prose}
+:::{.my-8 .max-w-3xl .mx-auto .rounded-lg .overflow-hidden .shadow .hover:shadow-xl}
+[![](/img/pages/react/react-gallery-dark.webp)](https://react.servicestack.net)
+:::
+:::
+
+ServiceStack's first-class React support positions your applications at the forefront of AI-assisted development. With declarative APIs, complete type safety, and minimal boilerplate, you can leverage AI code generation with confidence while maintaining the quality and maintainability your production systems demand.
+
+## TypeScript Data Models
+
+As AI Models are not as adept at generating C# APIs or Migrations yet, they excel at generating TypeScript code, which our 
+[TypeScript Data Models](/autoquery/okai-models) feature can take advantage of by generating all the C# AutoQuery CRUD APIs and DB Migrations needing to support it.
+
+With just a TypeScript Definition:
+
+- [Bookings.d.ts](https://github.com/NetCoreTemplates/react-vite/blob/main/MyApp.ServiceModel/Bookings.d.ts)
+
+We can generate all the AutoQuery CRUD APIs and DB Migrations needed to enable a CRUD UI with:
+
+:::copy
+npx okai Bookings.d.ts
+:::
+
+This is enough to generate a complete CRUD UI to manage Bookings 
+in your React App with the [React AutoQueryGrid Component](https://react.servicestack.net/gallery/autoquerygrid).
+or with ServiceStack's built-in [Locode UI](/locode/):
+
+:::{.not-prose}
+:::{.my-8 .max-w-3xl .mx-auto .rounded-lg .overflow-hidden .shadow .hover:shadow-xl}
+[![](/img/pages/react/bookings-locode.webp)](/locode/)
+:::
+:::
+
+
+### Cheat Sheet
+
+We'll quickly cover the common dev workflow for this feature. 
+
+To create a new Table use `init <Table>`, e.g:
+
+:::copy
+npx okai init Transaction
+:::
+
+This will generate an empty `MyApp.ServiceModel/<Table>.d.ts` file along with stub AutoQuery APIs and DB Migration implementations. 
+
+#### Regenerate AutoQuery APIs and DB Migrations
+
+After modifying the TypeScript Data Model to include the desired fields, you can re-run the `okai` tool to generate the AutoQuery APIs and DB Migrations 
+(which can be run anywhere within your Solution):
+
+:::copy
+npx okai Transaction.d.ts
+:::
+
+After you're happy with your Data Model you can run DB Migrations to run the DB Migration and create your RDBMS Table:
+
+:::copy
+npm run migrate
+:::
+
+#### Making changes after first migration
+
+If you want to make further changes to your Data Model, you can re-run the `okai` tool to update the AutoQuery APIs and DB Migrations, then run the `rerun:last` npm script to drop and re-run the last migration:
+
+:::copy
+npm run rerun:last
+:::
+
+#### Removing a Data Model and all generated code
+
+If you changed your mind and want to get rid of the RDBMS Table you can revert the last migration:
+
+:::copy
+npm run revert:last
+:::
+
+Which will drop the table and then you can get rid of the AutoQuery APIs, DB Migrations and TypeScript Data model with:
+
+:::copy
+npx okai rm Transaction.d.ts
+:::
+
+## AI-First Example
+
+There are a number of options for starting with an AI generated Application, with all the Instant AI App Generators like 
+[Google's App Studio](https://aistudio.google.com/apps) able to provide a great starting point. Although currently Professional Developers tend to use 
+[Cursor](https://cursor.com/), [Claude Code](https://www.claude.com/product/claude-code) or 
+[Codex](https://openai.com/codex/) as their day-to-day tools of choice. 
+
+### Use GitHub Copilot when creating a new Repository
+
+If you're using [GitHub Copilot](https://copilot.github.com/) you can also use it to generate a new App 
+[from the Vite React template ](https://github.com/new?template_name=react-vite&template_owner=NetCoreTemplates):
+
+:::{.not-prose}
+:::{.my-8 .max-w-3xl .mx-auto .rounded-lg .overflow-hidden .shadow .hover:shadow-xl}
+[![](/img/pages/react/react-new-repo.webp)](https://github.com/new?template_name=react-vite&template_owner=NetCoreTemplates)
+:::
+:::
+
+For the example, I've started with a useful App that I've never created before, a Budget Planner App, using the prompt:
+
+### Budget Planner Prompt
+
+```
+- React 19, TypeScript, TailwindCSS v4
+- Persistence in IndexedDB/localStorage
+- Recharts
+- Vitest with React Testing Library
+
+## Features
+Dashboard
+- Overview of total income, expenses, and remaining budget
+- Monthly summary chart (line graph)
+- Expense categories (pie chart)
+
+Transactions
+- Add/Edit/Delete income or expenses
+- Date filtering/sorting
+
+Budgets
+- Set monthly budget goals per category
+- Progress bars for spending vs. budget
+
+Reports
+- View past months
+- Export
+```
+
+The generated source code for the App was uploaded to: [github.com/mythz/budgets.apps.cafe](https://github.com/mythz/budgets.apps.cafe)
+
+### Budgent Planner App
+
+After a few minutes Copilot creates a PR with what we asked for, even things that we didn't specify in the prompt but could be inferred from the Project Template like **Dark Mode** support where it made use of the existing `<DarkModeToggle />`.
+
+<screenshots-gallery :images="{
+  'Dashboard': '/img/pages/react/budget/dashboard.webp',
+  'Dashboard - Dark Mode': '/img/pages/react/budget/dashboard-dark.webp',
+  'Transactions List - Dark Mode': '/img/pages/react/budget/transactions-list-dark.webp',
+  'Transactions - Add Expense': '/img/pages/react/budget/transactions-expense.webp',
+  'Transactions - Add Expense - Dark Mode': '/img/pages/react/budget/transactions-expense-dark.webp',
+  'Transactions - Add Income - Dark Mode': '/img/pages/react/budget/transactions-income-dark.webp',
+  'Budgets - Dark Mode': '/img/pages/react/budget/budgets-dark.webp',
+  'Reports': '/img/pages/react/budget/reports.webp',
+  'Reports - Dark Mode': '/img/pages/react/budget/reports-dark.webp',
+}"></screenshots-gallery>
+
+### Prompt AI to add new Features
+
+AI Assistance doesn't end after the initial implementation as AI Models and tools are more than capable to
+create 100% of the React UI now, including new features, fixes and other improvements. For this example I used
+Claude Code to Implement Category Auto-Tagging with this prompt:
+
+    Implement Category Auto-Tagging
+
+    Allow specifying tags when creating a new transaction.
+    When users add a transaction, try to predict the tag from the Description, e.g:
+
+    Input: “Starbucks latte” → Suggests category: Food & Drinks
+    Input: “Uber to work” → Suggests category: Transport
+
+    Implementation:
+
+    Maintain a small local list of common keywords + categories.
+    Pre-fill category in the transaction form as the user types in the Description.
+
+Which resulted in [this commit](https://github.com/mythz/budgets.apps.cafe/commit/e45a17b8dfd2b5983971554ced3e52ded6fa050e) which sees the feature available in the UI:
+
+:::{.not-prose}
+:::{.my-8 .max-w-3xl .mx-auto .rounded-lg .overflow-hidden .shadow .hover:shadow-xl}
+![](/img/pages/react/budget/expense-tags-dark.webp)
+:::
+:::
+
+Along with different seed data, tailored for Income and Expenses:
+ - [categoryAutoTag.ts](https://github.com/mythz/budgets.apps.cafe/blob/main/MyApp.Client/src/lib/categoryAutoTag.ts)
+ 
+And 19 passing tests to verify a working implementation:
+ 
+ - [categoryAutoTag.test.ts](https://github.com/mythz/budgets.apps.cafe/blob/main/MyApp.Client/src/lib/categoryAutoTag.test.ts)
+
+Combined with Vite's instant hot-reload, this creates a remarkably fluid development experience where
+we get to watch our prompts materialize into working features in real-time.
+
+All this to say that this new development model exists today, and given its significant productivity gains, it's 
+very likely to become the future of software development, especially for UIs. Since developers are no longer
+the primary authors of code, our UI choices swing from Developer preferences to UI technologies that AI models
+excel at.
+
+So whilst we have a preference for Vue given it's more readable syntax and progressive enhancement capabalities, and whilst .NET ecosystem has a strong bias towards Blazor, we're even more excited for the future of React and are committed to providing the best possible support for it.