Skip to content

Commit 241b4b6

Browse files
committed
updates
1 parent 0c529c8 commit 241b4b6

8 files changed

Lines changed: 33 additions & 59 deletions

File tree

MyApp/_includes/empty-projects.md

Lines changed: 5 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -5,32 +5,26 @@ If you don't have the [x dotnet tool](/dotnet-new) installed, the quickest way t
55
<h3 class="m-0 py-8 text-4xl text-center text-blue-600"><a href="https://servicestack.net/start">servicestack.net/start</a></h3>
66
</div>
77

8-
Alternatively if you're creating multiple projects we recommend installing the **x** dotnet tool which can create every project template:
9-
10-
:::sh
11-
dotnet tool install --global x
12-
:::
13-
148
### Empty Projects
159

1610
There are a few different ways you can create empty ServiceStack projects ordered by their level of emptiness.
1711

1812
To write a minimal .NET 8 Web App to your current directory, [mix](/mix-tool) in the **[init](https://gist.github.com/gistlyn/8026c4c2a7202b99885539109145e12b)** gist files to your current directory:
1913

2014
:::sh
21-
x mix init
15+
npx add-in init
2216
:::
2317

2418
To create an empty Single Project Template solution use the [empty](https://github.com/NetCoreTemplates/empty) template:
2519

2620
:::sh
27-
x new empty ProjectName
21+
npx create-net empty ProjectName
2822
:::
2923

3024
To create an empty 4 Project solution that adopts ServiceStack's [recommended project structure](/physical-project-structure), use the [web](https://github.com/NetCoreTemplates/web) template:
3125

3226
:::sh
33-
x new web ProjectName
27+
npx create-net web ProjectName
3428
:::
3529

3630
:::info
@@ -42,13 +36,13 @@ You can omit the **ProjectName** in all above examples to use the **Directory**
4236
Like C# **init** there's also **[init-fsharp](https://gist.github.com/gistlyn/3008acbe218fbcfb8278853825cc7ea3)** gist to create an empty F# Web App:
4337

4438
:::sh
45-
x mix init-fsharp
39+
npx add-in init-fsharp
4640
:::
4741

4842
### Empty VB .NET Template
4943

5044
And **[init-vb](https://gist.github.com/gistlyn/6e0677825059822fbaffec123403bf38)** to create an empty VB .NET Web App:
5145

5246
:::sh
53-
x mix init-vb
47+
npx add-in init-vb
5448
:::

MyApp/_pages/templates/angular-bootstrap.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,12 @@
22
title: Angular Bootstrap Project Template
33
---
44

5+
:::warning DEPRECATED
6+
The Angular Bootstrap Template has been deprecated in favor of the
7+
[Angular SPA Project Template](/templates/angular)
8+
:::
9+
10+
511
<div class="not-prose my-8 ml-20 flex justify-center"><svg style="max-width:200px" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
612
viewBox="0 0 250 250" xml:space="preserve">
713
<g>

MyApp/_pages/templates/aws.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,10 @@ title: AWS Project Templates
33
slug: templates-aws
44
---
55

6+
:::warning DEPRECATED
7+
The AWS Lambda Template has been deprecated in ServiceStack v10
8+
:::
9+
610
<div class="not-prose my-8 ml-20 flex justify-center"><svg style="max-width:200px" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
711
viewBox="0 0 364.707 364.707" enable-background="new 0 0 364.707 364.707"
812
xml:space="preserve">

MyApp/_pages/templates/corefx.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,10 @@ title: Run ASP.NET Core Apps on the .NET Framework
33
slug: templates-corefx
44
---
55

6+
:::warning DEPRECATED
7+
The ASP.NET Core on .NET Framework Project Templates have been deprecated in favor of using [.NET 10 Templates](/templates/)
8+
:::
9+
610
![](https://raw.githubusercontent.com/ServiceStack/Assets/master/csharp-templates/web.png)
711

812
### Status of ASP.NET Core on .NET Framework

MyApp/_pages/templates/empty.md

Lines changed: 0 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -13,29 +13,17 @@ The templates below follow our recommended [physical project layout](/physical-p
1313
<tr>
1414
<th>.NET 8.0</th>
1515
<th>.NET Framework</th>
16-
<th>ASP .NET Core on FX</th>
1716
<th>Empty Project Templates</th>
1817
</tr>
1918
<tr>
2019
<td><a href="https://github.com/NetCoreTemplates/web">web</a></td>
2120
<td><a href="https://github.com/NetFrameworkTemplates/web-netfx">web-netfx</a></td>
22-
<td><a href="https://github.com/NetFrameworkCoreTemplates/web-corefx">web-corefx</a></td>
2321
<td align="center">
2422
<h3>Empty Web Template</h3>
2523
<a href="http://web.web-templates.io"><img src="https://raw.githubusercontent.com/ServiceStack/Assets/master/csharp-templates/web.png" width="500" /></a>
2624
<p><a href="http://web.web-templates.io">web.web-templates.io</a></p>
2725
</td>
2826
</tr>
29-
<tr>
30-
<td><a href="https://github.com/LegacyTemplates/selfhost">selfhost</a></td>
31-
<td><a href="https://github.com/NetFrameworkTemplates/selfhost-netfx">selfhost-netfx</a></td>
32-
<td><a href="https://github.com/NetFrameworkCoreTemplates/web-corefx">selfhost-corefx</a></td>
33-
<td align="center">
34-
<h3>Empty SelfHost Console Template</h3>
35-
<a href="http://selfhost.web-templates.io"><img src="https://raw.githubusercontent.com/ServiceStack/Assets/master/csharp-templates/selfhost.png" width="500" /></a>
36-
<p><a href="http://selfhost.web-templates.io">selfhost.web-templates.io</a></p>
37-
</td>
38-
</tr>
3927
</table>
4028

4129

MyApp/_pages/templates/sidebar.json

Lines changed: 5 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -20,16 +20,16 @@
2020
"link": "/templates/blazor-components"
2121
},
2222
{
23-
"text": "Vue IdentityAuth SPA Template",
23+
"text": "Vue IdentityAuth Template",
2424
"link": "/templates/vue"
2525
},
2626
{
27-
"text": "React IdentityAuth SPA Template",
28-
"link": "/templates/react-spa"
27+
"text": "Angular IdentityAuth Template",
28+
"link": "/templates/angular"
2929
},
3030
{
31-
"text": "Angular IdentityAuth SPA Template",
32-
"link": "/templates/angular"
31+
"text": "React IdentityAuth Template",
32+
"link": "/templates/react-spa"
3333
},
3434
{
3535
"text": "Jamstack Templates",
@@ -55,22 +55,10 @@
5555
"text": "Nuxt Templates",
5656
"link": "/templates/nuxt"
5757
},
58-
{
59-
"text": "Angular Bootstrap Template",
60-
"link": "/templates/angular-bootstrap"
61-
},
62-
{
63-
"text": "AWS Lambda Templates",
64-
"link": "/templates/aws"
65-
},
6658
{
6759
"text": "Desktop Templates",
6860
"link": "/templates/desktop"
6961
},
70-
{
71-
"text": "ASP.NET Core on .NET Framework",
72-
"link": "/templates/corefx"
73-
},
7462
{
7563
"text": "Vue, React, Angular Components",
7664
"link": "/templates/spa-components"

MyApp/_pages/web-new.md

Lines changed: 9 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ protected Pages and Services and auth redirect flow to Sign In and Forbidden pag
8383
8484
![](/img/pages/auth/signin/angular-spa.png)
8585

86-
$ x new angular-spa ProjectName # .NET Core
86+
$ x new angular-spa ProjectName # .NET 10
8787
$ x new angular-spa-netfx ProjectName # Classic ASP.NET on .NET Framework
8888

8989
#### mvcauth
@@ -92,16 +92,15 @@ protected Pages and Services and auth redirect flow to Sign In and Forbidden pag
9292
9393
![](/img/pages/auth/signin/mvcauth.png)
9494

95-
$ x new mvcauth ProjectName # .NET Core
95+
$ x new mvcauth ProjectName # .NET 10
9696

9797
#### razor
9898

9999
> ServiceStack.Razor Bootstrap Website
100100
101101
![](/img/pages/auth/signin/razor.png)
102102

103-
$ x new razor ProjectName # .NET Core
104-
$ x new razor-corefx ProjectName # ASP.NET Core on .NET Framework
103+
$ x new razor ProjectName # .NET 10
105104
$ x new razor-netfx ProjectName # Classic ASP.NET on .NET Framework
106105

107106
#### react-spa
@@ -110,7 +109,7 @@ protected Pages and Services and auth redirect flow to Sign In and Forbidden pag
110109
111110
![](/img/pages/auth/signin/react-spa.png)
112111

113-
$ x new react-spa ProjectName # .NET Core
112+
$ x new react-spa ProjectName # .NET 10
114113
$ x new react-spa-netfx ProjectName # Classic ASP.NET on .NET Framew
115114

116115
#### script
@@ -119,8 +118,7 @@ protected Pages and Services and auth redirect flow to Sign In and Forbidden pag
119118
120119
![](/img/pages/auth/signin/script.png)
121120

122-
$ x new script ProjectName # .NET Core
123-
$ x new script-corefx ProjectName # ASP.NET Core on .NET Framework
121+
$ x new script ProjectName # .NET 10
124122
$ x new script-netfx ProjectName # Classic ASP.NET on .NET Framework
125123

126124
#### vue-spa
@@ -129,7 +127,7 @@ protected Pages and Services and auth redirect flow to Sign In and Forbidden pag
129127
130128
![](/img/pages/auth/signin/vue-spa.png)
131129

132-
$ x new vue-spa ProjectName # .NET Core
130+
$ x new vue-spa ProjectName # .NET 10
133131
$ x new vue-spa-netfx ProjectName # Classic ASP.NET on .NET Framework
134132

135133
### Create Customized Projects with mix
@@ -139,18 +137,10 @@ All new projects can be further customized with [mix](/mix-tool) dotnet tool to
139137

140138
## Why a new project template system?
141139

142-
It's not often that a tool causes enough friction that it ends up requiring less effort to develop a replacement than
143-
it is to continue using the tool. But this has been our experience with maintaining our VS.NET Templates in the
144-
[ServiceStackVS](https://github.com/ServiceStack/ServiceStackVS) VS.NET Extension which has been the biggest time sink of all our
145-
3rd Party Integrations where the iteration time to check in a change, wait for CI build, uninstall/re-install the VS.NET extension
146-
and create and test new projects is measured in hours not minutes. To top off the poor development experience we've now appeared to have
147-
reached the limits of the number of Project Templates we can bundle in our 5MB **ServiceStackVS.vsix** VS.NET Extension as a
148-
number of Customers have reported seeing VS.NET warning messages that ServiceStackVS is taking too long to load.
140+
It's not often that a tool causes enough friction that it ends up requiring less effort to develop a replacement than it is to continue using the tool. But this has been our experience with maintaining our VS.NET Templates in the [ServiceStackVS](https://github.com/ServiceStack/ServiceStackVS) VS.NET Extension which has been the biggest time sink of all our 3rd Party Integrations where the iteration time to check in a change, wait for CI build, uninstall/re-install the VS.NET extension and create and test new projects is measured in hours not minutes. To top off the poor development experience we've now appeared to have reached the limits of the number of Project Templates we can bundle in our 5MB **ServiceStackVS.vsix** VS.NET Extension as a number of Customers have reported seeing VS.NET warning messages that ServiceStackVS is taking too long to load.
149141

150142
Given all the scenarios ServiceStack can be used in, we needed a quicker way to create, update and test our growing **47 starting project templates**.
151-
In the age of simple command-line dev tools like git and .NET Core's light weight text/human friendly projects, maintaining and creating
152-
new .NET project templates still feels archaic & legacy requiring packaging projects as binary blobs in NuGet packages which become stale
153-
the moment they're created.
143+
In the age of simple command-line dev tools like git and .NET Core's light weight text/human friendly projects, maintaining and creating new .NET project templates still feels archaic & legacy requiring packaging projects as binary blobs in NuGet packages which become stale the moment they're created.
154144

155145
## How it works
156146

@@ -185,7 +175,7 @@ Best of all creating and testing projects are now much easier since project temp
185175
that when a new project is created with:
186176

187177
```shell
188-
$ x new <template> ProjectName
178+
$ x new <template> ProjectName
189179
```
190180

191181
Replaces all occurrences in all text files, file and directory names, where:
26.6 KB
Loading

0 commit comments

Comments
 (0)