Skip to content

Configurator & CLI

Create a project two ways — the CLI (dotnet new netforge) or the online configurator. The options map 1:1, so the configurator simply builds the same command.

Options

CLI flagConfiguratorValuesDefaultEffect
-n, --nameProject nameidentifierNetForgeNames the solution, namespaces, and folders.
--tierEditionpro | basicprobasic strips the premium subsystems for the free MIT edition.
--databaseDatabasesqlite | postgres | sqlserversqliteProvider the scaffold is wired for. Server DBs ship a docker-compose. See Databases.
--devSplitUse SQLite for local devtrue | falsefalse(Server DB only) SQLite locally, server DB in production.
--IncludeDemoDemo (Sales) domaintrue | falsetrue (Pro)The sample Sales vertical + its tests. Pro only.
--brandColorAccent colourCSS colour(theme)Starting brand accent, baked into the scaffold.
--brandThemeThemeocean/forest/sunset/…(theme)Starting curated theme.
--opt<Feature>per-feature togglesdefault/on/offdefaultForce an individual subsystem on/off regardless of tier (e.g. --optWebhooks off).
--Google / --Microsoft / --GitHubOAuth providerstrue/falsetrueInclude that provider's wiring (still config-gated at runtime).

Per-feature toggles

The tier is a baseline; every premium feature is individually settable with --opt<Feature> (default follows the tier; on/off force it). Dependencies cascade — turning off a feature another depends on turns that one off too, so every combination produces a buildable project.

bash
# A lean core, but add back audit + the global search palette:
dotnet new netforge -n App --tier basic --optAudit on --optSearch on

# Full Pro, but no multi-tenancy and no file uploads:
dotnet new netforge -n App --optMultiTenant off --optFileUploads off

Tunable later

Almost everything is changeable after scaffolding: the database via Database:Provider, the theme/accent at /admin/appearance, permissions at /admin/roles, and features via config. See Configuration.

NetForge Community is MIT-licensed. Pro is a commercial edition.