Burcin

The template replaces the BurcinCo, BurcinApp, and BurcinDatabase sentinel names with the organization, project, and database values supplied at generation time. The Burcin template name and attribution remain Burcin.

Install

# retrieves latest
dotnet new install "Burcin.Templates.CSharp"

# retrieves a specific version with source definition
dotnet new install "Burcin.Templates.CSharp::1.2.21" --nuget-source https://api.nuget.org/v3/index.json

Update

Warning

It looks like --update-* commands are not working (4/22/2020)

# checks if there is an update
dotnet new "Burcin.Templates.CSharp" --update-check

# applies if there is an update
dotnet new "Burcin.Templates.CSharp" --update-apply

Uninstall

dotnet new uninstall "Burcin.Templates.CSharp"

Help

dotnet new burcin --help

Run

cd "<PATH>"; #e.g. C:\Users\<USERNAME>\Source\local\<MYPROJECT>

# Full Modular Polylith on .NET 10 (the canonical example):
dotnet new burcin --name "MyFolder" `
    --OrganizationLegalName "MyOrganization, Inc." --OrganizationName "MyOrganization" --ProjectName "MyProject" `
    --DatabaseName "MyProjectDb" --Authors "Your Name" `
    --RepositoryUrl "https://github.com/<changeme>/myproject" `
    --Sample --Cache "All" `
    --DocFx --GitHubTemplates `
    --SkipRestore;

# Minimal scaffold (no EF / no reference modules / no OData):
dotnet new burcin --name "MyFolder" `
    --OrganizationLegalName "MyOrganization, Inc." --OrganizationName "MyOrganization" --ProjectName "MyService" `
    --DatabaseName "MyServiceDb" --Authors "Your Name" `
    --SkipRestore;

The generated project's README.md reflects the selected options. With --Sample, it documents the Modular Polylith reference modules, per-module schemas, Outbox/Inbox flows, Aspire AppHost orchestration, the Gateway-owned Webhook edge adapter, and how to add a new module; minimal output omits claims about projects it did not generate.

Verify local template changes

Copy-Item tests/.env.example tests/.env
# Fill in tests/.env, then generate the canonical Sample fixture with a private template hive.
./tests/CreateProject.ps1 -Versioned

CreateProject.ps1 packs the current template, installs it into an isolated private hive, and writes the generated fixture beneath tests/TestResults.ignore without changing the globally installed template.

List all templates

dotnet new list burcin;