Getting Started
Prerequisites
| Tool | Version |
|---|---|
| .NET SDK | 10.0.100 or later (see global.json) |
| Node.js | 24 or later, with npm 11 (see .node-version) |
| Docker | Optional. Needed only for the .NET Aspire AppHost when it starts containers |
The packages come from three preview feeds, which NuGet.config already lists:
| Packages | Feed |
|---|---|
OrchardCore.* | https://nuget.cloudsmith.io/orchardcore/preview/v3/index.json |
CrestApps.Core* | https://nuget.cloudsmith.io/crestapps/crestapps-core/v3/index.json |
CrestApps.OrchardCore.* | https://nuget.cloudsmith.io/crestapps/crestapps-orchardcore/v3/index.json |
Build and test
dotnet build CrestApps.Estimator.slnx -c Release -warnaserror
dotnet test -c Release --no-build ./tests/CrestApps.OrchardCore.Estimator.Tests/CrestApps.OrchardCore.Estimator.Tests.csproj
The build treats every warning as an error, and NuGet audit fails the build on any known vulnerability.
Run the web host
cd src/Startup/CrestApps.Estimator.Cms.Web
dotnet run
The site starts at https://localhost:5001. On the first run, Orchard Core shows the setup screen. Pick the Estimator recipe to get a site with the admin dashboard and the Estimator features turned on. The User Manual shows the setup screen step by step.
To run the host through .NET Aspire instead:
cd src/Startup/CrestApps.Estimator.Aspire.AppHost
dotnet run
The Estimator setup recipe
The Estimator recipe (src/Modules/CrestApps.OrchardCore.Estimator/Recipes/estimator.recipe.json) is a setup recipe. It enables these features and sets the themes:
| Step | What it does |
|---|---|
feature | Enables OrchardCore.Admin, OrchardCore.Diagnostics, OrchardCore.Features, OrchardCore.Navigation, OrchardCore.Recipes, OrchardCore.Resources, OrchardCore.Roles, OrchardCore.Settings, OrchardCore.Themes, OrchardCore.Users, TheAdmin, TheTheme and CrestApps.OrchardCore.Estimator. Enabling the Estimator feature also enables its dependencies |
themes | Sets TheAdmin as the admin theme and TheTheme as the site theme |
Build front-end assets
The modules build their scripts and styles with the same asset pipeline as CrestApps Orchard Core (Vite, driven by .scripts/assets).
npm install
npm run rebuild
npm run lint
No Estimator module has front-end assets yet.