Run the template locally

Prerequisites

Install:

• .NET 10 SDK;
• Node.js 24 or a compatible current LTS release;
• npm;
• SQLite CLI for the diagnostic and verification scripts;
• Git.

Stripe CLI is optional until the Stripe sandbox step. PostgreSQL is only required for production and the optional integration test.

Confirm the local toolchain from the repository root:

./scripts/doctor.sh

Warnings about Stripe or email are expected for a new local checkout. Errors should be resolved before continuing.

Install dependencies

Install the browser dependencies and the small Node toolchain used by the ASP.NET host:

cd MyApp.Client
npm install

cd ../MyApp
npm install

NuGet packages are restored automatically by dotnet build or dotnet watch.

Start the application

cd MyApp
dotnet watch

Open https://localhost:5001. ASP.NET Core owns the public origin and starts the Next.js development process automatically. Browser API requests therefore use the same origin as Identity cookies and ServiceStack APIs.

The first Development start with no application database:

1. creates the ASP.NET Core Identity schema;
2. runs the OrmLite SaaS migrations;
3. seeds Free, Pro, Business, and Enterprise plans;
4. creates development users;
5. creates a personal organization and Free subscription when a seeded user first signs in.

Development accounts

All seeded users use the password p@55wOrd.

Seed users are created only in Development. Production startup never creates known credentials.

Check the application

After signing in, verify:

• /dashboard loads the active organization once without repeated API calls;
• /documents permits a small supported file upload;
• /usage displays document and storage usage;
• /settings displays organization lifecycle controls for an Owner;
• /admin opens the Operations Center for admin@email.com; its side menu links to the focused /admin/* routes;
• /up and /ready return healthy responses.

API contracts and diagnostic tools are available at /scalar/v1, /ui, and /admin-ui.

Recreate local state

This template is designed to recreate itself from an empty development database. Stop the application, then run:

ASPNETCORE_ENVIRONMENT=Development ./scripts/reset-dev.sh --yes

The script validates exact paths before removing MyApp/App_Data/app.db and MyApp/App_Data/files. It then runs the migration task. It refuses to run outside Development or without --yes.

ServiceStack Background Jobs and request logs use separate generated SQLite databases under MyApp/App_Data/jobs and MyApp/App_Data/requests. They are operational development artifacts and can also be removed while the application is stopped.

Common setup problems

The HTTPS certificate is not trusted

Trust the ASP.NET Core development certificate:

dotnet dev-certs https --trust

Port 5001 or 3000 is already in use

Stop the previous dotnet watch, dotnet run, or Next.js development process before starting another instance.

The schema does not match the code

During template development, recreate the local database with reset-dev.sh. Derived production applications should add a forward migration instead.

Paid checkout is unavailable

That is expected until Stripe sandbox keys and plan Price IDs are configured in step 6.