You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/en/cli/index.md
+42-1Lines changed: 42 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -39,7 +39,7 @@ Here is the list of all available commands before explaining their details:
39
39
-`**[help](../cli#help)`**: Shows help on the usage of the ABP CLI.
40
40
-`**[cli](../cli#cli)`**: Update or remove ABP CLI.
41
41
-`**[new](../cli#new)**`: Generates a new solution based on the ABP [startup templates](../solution-templates/index.md). Use `--modern` to create solutions with the modern template system (React UI).
42
-
-`**[new-module](../cli#new-module)**`: Generates a new module based on the given template.
42
+
-`**[new-module](../cli#new-module)**`: Generates a new module based on the given template. Use `--modern` to use modern module templates.
43
43
-`**[new-package](../cli#new-package)**`: Generates a new package based on the given template.
44
44
-`**[update](../cli#update)**`: Automatically updates all ABP related NuGet and NPM packages in a solution.
45
45
-`**[clean](../cli#clean)**`: Deletes all `BIN` and `OBJ` folders in the current folder.
@@ -251,6 +251,17 @@ For more samples, go to [ABP CLI Create Solution Samples](new-command-samples.md
251
251
-`--legacy`: Generates a legacy solution.
252
252
-`trust-version`: Trusts the user's version and does not check if the version exists or not. If the template with the given version is found in the cache, it will be used, otherwise throws an exception.
253
253
254
+
##### Modern Template Options
255
+
256
+
The following options apply only when `--modern` is used:
257
+
258
+
| Option | Description | Templates |
259
+
| --- | --- | --- |
260
+
|`--shadcn-theme <theme>`| Shadcn/UI color theme. See [Shadcn Theme Values](#shadcn-theme-values). | all `--modern` templates |
261
+
|`--admin-password <password>`| Initial admin user password. | all `--modern` templates |
262
+
|`--modular`| Generates a modular monolith variant. |`app-nolayers --modern`|
Add `--modern` to any template to use its modern variant. Modern templates use a different template source (shipped with ABP Studio) compared to legacy templates (which use NuGet extension packages). They are **React-first** and have a narrower set of supported options.
@@ -270,6 +281,10 @@ abp new Acme.BookStore --template microservice --modern
270
281
271
282
272
283
> Blazor, Angular, MVC, and MAUI Blazor UI frameworks are **not** supported with `--modern`. The `maui` mobile option is also not supported with `--modern`.
284
+
>
285
+
> Options that are not supported by a modern template are ignored with a warning in the CLI output.
286
+
>
287
+
> `--modern` can also be used with `--ready-config-path` and `--solution-history-id`. In these cases, the template in the JSON configuration is mapped to its modern variant.
273
288
274
289
When using `--template microservice --modern`, the generated solution includes:
-`--template` or `-t`: Specifies the template name. Default template name is `module:ddd`, which generates a DDD module. Module templates are provided by the main template, see their own startup template documentation for available modules. `empty:empty` and `module:ddd` template is available for all solution structure.
349
+
-`--modern`: Uses the modern variant of the selected module template.
323
350
-`--output-folder` or `-o`: Specifies the output folder. Default value is the current directory.
324
351
-`--target-solution` or `-ts`: If set, the new module will be added to the given solution. Otherwise the new module will added to the closest solution in the file system. If no solution found, it will throw an error.
325
352
-`--solution-folder` or `-sf`: Specifies the target folder in the [Solution Explorer](../studio/solution-explorer.md#folder) virtual folder system.
0 commit comments