Quick Start

Download the stack and run the setup wizard to configure your project in minutes.

Download from Customer Portal

Log into the customer portal at portal.twocents.software with the credentials from your purchase confirmation email.

Download the latest version of Two Cents Software Stack (.NET). Extract the ZIP file to your development folder.

bash
1cd ~/projects
2unzip two-cents-software-stack-dotnet-2026.1.1.zip
3cd two-cents-software-stack-dotnet
Scroll for more

Run the Setup Wizard

The setup wizard is an interactive CLI tool that configures 122 settings across all features. Navigate to the wizard directory and start the setup:

bash
1cd wizard
2npm install
3npm run setup
Scroll for more

The wizard presents several quick start presets to get you started faster.

Quick Start Presets

B2B - Team Workspaces - Workspace subscriptions, seat-based pricing, team groups

B2C - Personal Pro - User subscriptions, personal workspaces, social authentication

Simple App - No billing, basic authentication, minimal configuration

Playground - Everything enabled for exploration

Select a preset or choose custom configuration to answer all questions individually.

What the Wizard Configures

The wizard handles configuration for:

Project Basics - Project name, company name, frontend URL, backend URL, database connection

Authentication - Email/password, OAuth providers (Google, GitHub), magic links, two-factor authentication

Multi-Tenancy - Workspaces, groups, roles, invitations

Billing - Stripe integration, subscription plans, pricing, seat-based billing

Security - Password policies, session management, account lockout, data export

Storage - File storage provider (Local, S3, Cloudflare R2, Azure Blob)

Email - Email provider (Console, Resend, SendGrid, SMTP)

Background Jobs - Hangfire configuration, cleanup jobs, scheduled tasks

CRM - HubSpot integration (optional)

The wizard generates all configuration files with feature flags set according to your selections.

Generated Files

The wizard creates:

Backend:

  • backend/appsettings.Development.json - Development configuration
  • backend/appsettings.Production.json - Production configuration
  • Feature-specific configuration files

Frontend:

  • frontend/.env.local - Frontend environment variables
  • frontend/src/App.tsx - Application entry point with enabled features

Secrets use placeholder values that you replace with actual API keys.

Test Configuration (Optional)

Preview configuration without modifying source files:

bash
1npm run setup:test
Scroll for more

Generated files appear in wizard/test-output/ for review before applying to your project.

Managing Secrets

After running the wizard, manage sensitive values like API keys and secrets:

bash
1npm run secrets
Scroll for more

This command scans your configuration for sensitive values and helps you store them securely using .NET User Secrets (recommended for development) or environment variables.

Next Steps

Configuration is generated and ready. Now you need to:

  1. Install dependencies - Follow Prerequisites to install .NET 10, Node.js 20+, and PostgreSQL
  2. Run database migrations - Set up your database schema
  3. Start the application - Run backend and frontend servers
  4. Configure API keys - Replace placeholder values with actual keys for Stripe, OAuth, email providers

Review Project Structure to understand how the codebase is organized.

Additional Wizard Commands

Validate configuration:

bash
1npm run validate-config
Scroll for more

Checks for missing settings, security issues, invalid API keys, and feature inconsistencies.

Restore from backup:

bash
1npm run restore
Scroll for more

The wizard automatically creates backups before each setup run. Restore from the last 5 backups if needed.

Deployment configuration:

bash
1npm run setup:deploy
Scroll for more

Configures your project for cloud deployment to Railway or Azure. This command generates platform-specific deployment files including Dockerfiles, configuration files, and complete deployment guides.

Platform Options:

  • Railway with Neon PostgreSQL
  • Azure App Service or Container Apps with Azure Database for PostgreSQL

Generated Files:

  • Dockerfile - Multi-stage build with .NET 10
  • .dockerignore - Excludes frontend, wizard, and unnecessary files
  • railway.toml - Railway deployment configuration
  • docs/deployment-railway.md - Complete Railway deployment guide
  • docs/deployment-azure.md - Complete Azure deployment guide

The command also updates Program.cs to handle platform-specific configuration like Railway DATABASE_URL parsing and forwarded headers for proxies.

Test deployment configuration:

bash
1npm run setup:deploy:test
Scroll for more

Previews deployment files in wizard/test-output/ without modifying your project.

Previous
Introduction