Modern enterprise architecture requires development environments to exhibit strict determinism and platform parity. BitzOrcas.Modern is built upon .NET 10 LTS and C# 14, relying heavily on Roslyn incremental Source Generators and Native AOT static analysis, while the frontend administrative monorepo utilizes React 19, Vite 8, and Yarn 4.17.0 Berry.

Before cloning the repository, verify that your development machine satisfies all required cross-platform toolchain prerequisites.

Development Toolchain Topology

Step 1: Install Foundational Toolchains by Operating System

Option A: macOS (Recommended via Homebrew)

Execute the following commands in Terminal to install all required dependencies:

# 1. Install .NET 10 SDK
brew install --cask dotnet-sdk

# 2. Install Node.js 22 LTS
brew install node@22

# 3. Enable Corepack to activate embedded Yarn 4.17.0 Berry
corepack enable

# 4. Install Docker container runtime (native Docker Desktop or lightweight OrbStack)
brew install --cask docker
# Or choose lightweight OrbStack:
# brew install --cask orbstack

# 5. Register and trust local ASP.NET Core HTTPS developer root certificates
dotnet dev-certs https --trust

Option B: Linux (Ubuntu 24.04 LTS / Debian 12)

Configure Microsoft’s official package repository and install build dependencies:

# 1. Register Microsoft package signing key and repository
wget https://packages.microsoft.com/config/ubuntu/24.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

# 2. Install .NET 10 SDK and Native AOT build prerequisites (clang/zlib)
sudo apt-get update && sudo apt-get install -y dotnet-sdk-10.0 clang zlib1g-dev

# 3. Install Node.js 22 LTS and enable Corepack
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
sudo corepack enable

# 4. Install Docker Engine and Docker Compose plugin
sudo apt-get install -y docker.io docker-compose-v2
sudo usermod -aG docker $USER
newgrp docker

# 5. Generate local development certificates
dotnet dev-certs https

Option C: Windows 11 (via winget and PowerShell)

Launch Windows Terminal (PowerShell) as Administrator and run:

# 1. Install .NET 10 SDK, Node.js LTS, and Docker Desktop
winget install Microsoft.DotNet.SDK.10 --accept-source-agreements --accept-package-agreements
winget install OpenJS.NodeJS.LTS --accept-source-agreements --accept-package-agreements
winget install Docker.DockerDesktop --accept-source-agreements --accept-package-agreements

# 2. Enable Corepack and trust developer certificates
corepack enable
dotnet dev-certs https --trust

Step 2: Toolchain Version Assertions

Verify all installed command-line utilities in your shell before proceeding to ensure they meet the minimum required versions:

# 1. Verify .NET SDK (Major version must be >= 10.0)
dotnet --version

# 2. Verify Node.js runtime (Recommended v22.x)
node --version

# 3. Verify Yarn package manager (Managed via Corepack as Yarn 4.17.0 inside repo)
yarn --version

# 4. Verify Docker daemon and Compose plugin
docker --version
docker compose version

Expected terminal output:

10.0.100
v22.12.0
4.17.0
Docker version 27.0.3, build 7d4bed8
Docker Compose version v2.28.1

Step 3: Recommended IDEs and Productivity Extensions

1. JetBrains Rider (Primary Recommendation)

BitzOrcas.Modern includes root .editorconfig and BitzOrcas.Modern.sln.DotSettings:

Native Support: Full symbol resolution and instant navigation across Roslyn incremental Source Generator virtual syntax trees.
Recommended Plugins:
- Database Tools and SQL: Native direct connections to SQL Server on port 1433;
- Tailwind CSS: Intelligent styling completion for frontend/.

2. Visual Studio 2026 / 17.12+

Workloads: ASP.NET and web development, .NET desktop development;
Individual components: .NET 10.0 Runtime, MSVC v143 - VS 2022 C++ x64/x86 build tools (required for local Native AOT publishing).

3. Visual Studio Code

Essential extensions: C# Dev Kit (ms-dotnettools.csdevkit);
Frontend extensions: ESLint, Tailwind CSS IntelliSense.

With your development toolchains verified, proceed to Code Installation & Local Configuration to provision containers and initialize the database.