Skip to content

Commit 3a45a7e

Browse files
mythzmythz
committed
Add Whats New Posts
1 parent c7adaac commit 3a45a7e

File tree

4 files changed

+100
-2
lines changed

4 files changed

+100
-2
lines changed

‎MyApp/_posts/2025-12-03_openapi-net10.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -87,3 +87,24 @@ Another alternative we've discovered to avoid build issues is to disable its XML
8787
</ItemGroup>
8888
</Target>
8989
```
90+
91+
92+
## npx scripts
93+
94+
A new **v10.0.0** version of the **x** dotnet tool is now available with.NET 10 support:
95+
96+
```bash
97+
dotnet tool install --global x # install
98+
dotnet tool update -g x # update
99+
```
100+
101+
Although this is likely the last .NET runtime that will be supported as the `x` dotnet tool is being phased out in favor of use-case specific `npx` scripts which doesn't require a separate install and can be used in all environments without needing .NET installed.
102+
103+
The npx tools have the same behavior as the different x sub-features where you can just replace the command prefix with the npx script equivalent, e.g:
104+
105+
| x command | npx script | description |
106+
| ------------ | ----------------------- | ----------- |
107+
| `x new` | `npx create-net` | Create a new App from a .NET 10 project template |
108+
| `x mix` | `npx add-in` | Register and configure a Plugin with your App |
109+
| `x ts` | `npx get-dtos ts` | Regenerate latest TypeScript DTOs |
110+
| `x ts <url>` | `npx get-dtos ts <url>` | Generate new TypeScript DTOs for the remote ServiceStack App|

‎MyApp/_posts/2025-12-04_vibecode-react-templates.md‎

Lines changed: 45 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,6 @@ summary: Exploring the new Vibe Codable .NET 10 React Templates and their NodePr
44
tags: [react,ai,autoquery]
55
author: Demis Bellot
66
image: ./img/posts/vibecode-react-templates/bg.webp
7-
draft: true
87
---
98

109
Over the last few months our primary focus has been on enabling first-class support for React, this is a contrast from our own decade-long personal preference for Vue which has better affinity with HTML and its support for progressive enhancement enabling a [Simple, Modern JavaScript](https://servicestack.net/posts/javascript) development workflow without requiring npm or any build tools and why it was chosen for all of ServiceStack's [built-in UIs](https://servicestack.net/auto-ui). Whilst our [focus for Blazor](https://servicestack.net/blazor) was driven by .NET's preference for Blazor given it's primary positioning by the .NET team.
@@ -126,4 +125,48 @@ In addition to the minimal starting templates above, we've also created 2 full-f
126125

127126
All deployments include the GitHub Action workflows to deploy your App to [any Linux Server with Kamal](https://react-templates.net/docs/deployments) using Docker, SSH and GitHub Container Registry (ghcr).
128127

129-
Where you can host it on a [Hetzner US Cloud](https://www.hetzner.com/cloud) VM for as low as **$5 per month** or if you have multiple Apps you can delpoy them all to a single VM which we're doing for our .NET Template Live Demos which runs **30 Docker Apps** on a **8GB RAM/80GB SSD** dedicated VM for **$15 /month**.
128+
Where you can host it on a [Hetzner US Cloud](https://www.hetzner.com/cloud) VM for as low as **$5 per month** or if you have multiple Apps you can delpoy them all to a single VM which we're doing for our .NET Template Live Demos which runs **30 Docker Apps** on a **8GB RAM/80GB SSD** dedicated VM for **$15 /month**.
129+
130+
## AI-Assisted Development with CLAUDE.md
131+
132+
As part of our objectives of improving developer experience and embracing modern AI-assisted development workflows - all new .NET React templates include a comprehensive `AGENTS.md` file designed to optimize AI-assisted development workflows.
133+
134+
### What is CLAUDE.md?
135+
136+
`CLAUDE.md` and [AGENTS.md](https://agents.md) onboards Claude (and other AI assistants) to your codebase by using a structured documentation file that provides it with complete context about your project's architecture, conventions, and technology choices. This enables more accurate code generation, better suggestions, and faster problem-solving.
137+
138+
### What's Included
139+
140+
Each template's `AGENTS.md` contains:
141+
142+
- **Project Architecture Overview** - Technology stack, design patterns, and key architectural decisions
143+
- **Project Structure** - Gives Claude a map of the codebase
144+
- **ServiceStack Conventions** - DTO patterns, Service implementation, AutoQuery, Authentication, and Validation
145+
- **React Integration** - TypeScript DTO generation, API client usage, component patterns, and form handling
146+
- **Database Patterns** - OrmLite setup, migrations, and data access patterns
147+
- **Common Development Tasks** - Step-by-step guides for adding APIs, implementing features, and extending functionality
148+
- **Testing & Deployment** - Test patterns and deployment workflows
149+
150+
### Extending with Project-Specific Details
151+
152+
The existing `CLAUDE.md` serves as a solid foundation, but for best results, you should extend it with project-specific details like the purpose of the project, key parts and features of the project and any unique conventions you've adopted.
153+
154+
### Benefits
155+
156+
- **Faster Onboarding** - New developers (and AI assistants) understand project conventions immediately
157+
- **Consistent Code Generation** - AI tools generate code following your project's patterns
158+
- **Better Context** - AI assistants can reference specific ServiceStack patterns and conventions
159+
- **Reduced Errors** - Clear documentation of framework-specific conventions
160+
- **Living Documentation** - Keep it updated as your project evolves
161+
162+
### How to Use
163+
164+
Claude Code and most AI Assistants already support automatically referencing `CLAUDE.md` and `AGENTS.md` files, for others you can just include it in your prompt context when asking for help, e.g:
165+
166+
> Using my project's AGENTS.md, can you help me add a new AutoQuery API for managing Products?
167+
168+
The AI will understand your App's ServiceStack conventions, React setup, and project structure, providing more accurate and contextual assistance.
169+
170+
### Getting Started
171+
172+
All new [react-templates.net](https://react-templates.net) include [AGENTS.md](https://github.com/NetCoreTemplates/react-static/blob/main/AGENTS.md) by default. For existing projects, you can adapt the template to document your App's conventions, patterns and technology choices.

‎MyApp/_whatsnew/2025-12-02_v10.0/openapi-net10.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
title: .NET 10 LTS and new OpenAPI Scalar + Swagger UIs
3+
url: /posts/openapi-net10
4+
image: /img/posts/openapi-net10/bg.webp
5+
order: 1
6+
---
7+
8+
We're excited to announce **ServiceStack v10** - a major release aligned with Microsoft's newly released .NET 10 LTS. This milestone release brings first-class .NET 10 support across the entire ServiceStack ecosystem, with all packages now shipping native .NET 10 builds optimized for the latest runtime.
9+
10+
As part of this major upgrade, we've modernized and streamlined our tooling:
11+
12+
- All project templates upgraded to .NET 10
13+
- Adopted the new modern, simplified `.slnx` solution format
14+
- Enhanced Kamal GitHub Action deployments
15+
16+
### New .NET 10 OpenAPI Packages
17+
- **ServiceStack.OpenApi.Swashbuckle** with Swagger UI
18+
- **ServiceStack.OpenApi.Microsoft** with Scalar UI

‎MyApp/_whatsnew/2025-12-02_v10.0/vibecode-react-templates.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
---
2+
title: New Vibe Codable .NET 10 React Templates
3+
url: https://react-templates.net
4+
image: ./img/posts/vibecode-react-templates/bg.webp
5+
order: 2
6+
---
7+
8+
We're excited to announce [react-templates.net](https://react-templates.net) - a new collection of 5 React templates optimized for AI-assisted development with .NET 10. As AI Models become proficient enough to build features in minutes and rewrite UIs in hours, we've focused on the stack where AI excels: **React 19**, **Next.js 16**, **TypeScript**, and **Tailwind CSS v4**.
9+
10+
The new templates feature a new **NodeProxy architecture** that eliminates the complexity of managing separate dev servers. Simply run `dotnet watch` to access your React App at `https://localhost:5001` with full HMR support:
11+
12+
- **react-static** and **next-static** - Minimal starting templates with static exports
13+
- **react-spa** and **nextjs** - Full-featured templates with Blog, MDX, shadcn/ui
14+
- **next-rsc** - Cutting-edge React Server Components with .NET API access
15+
16+
All templates seamlessly integrate .NET APIs, Razor Pages, and React UIs, integrates Identity Auth, and comes with comprehensive **AGENTS.md** files for optimal AI-assisted development. Start your next project at [react-templates.net](https://react-templates.net)

0 commit comments

Comments
 (0)