imagile 0.2.187

Imagile

A multi-tenant B2B application platform built with .NET 9, Blazor WebAssembly, and Azure.

Quick Start

Prerequisites: .NET 9.0 SDK, Docker

# Start local services (SQL Server, Azurite)
docker-compose up -d

# Build and test
dotnet restore Imagile.App.sln
dotnet build Imagile.App.sln
dotnet test

Marketing Website (Dotcom)

Prerequisites: Node.js 20+

cd Imagile.Web.Dotcom

# Install dependencies (first time)
npm install

# Run dev server with hot reload
npm run dev
# Visit http://localhost:4321

# Build for production
npm run build

Documentation

• CLAUDE.md - Development guide, build commands, testing, deployment workflows
• infra/README.md - Infrastructure architecture, Bicep modules, deployment procedures
• .github/copilot-instructions.md - Coding standards and conventions

Architecture

Multi-tenant sharded database:

• Metabase: Central tenant registry
• Tenant shards: Distributed tenant data across multiple databases
• Query isolation via ITenantIdEntity interface

Projects:

• Imagile.App.Api - ASP.NET Core Web API (Container Apps)
• Imagile.App.Functions - Azure Functions (background processing)
• Imagile.App.Ui.Web - Blazor WebAssembly UI (Static Web Apps)
• Imagile.Web.Dotcom - Astro marketing website (www.imagile.dev, imagile.dev)
• Imagile.App.Cli - Command-line tool (published to NuGet)
• Imagile.Tests.Predeployment - Database design validation
• Imagile.Tests.Postdeployment - E2E tests (Playwright + Reqnroll)

Deployment

Environments:

• Local - Docker Compose (localhost:3433)
• QA - Azure centralus (qa-*.imagile.dev)
• Production - Azure centralus (*.imagile.dev)

Pipeline: Push to main → Build → QA → E2E Tests → Production

See CLAUDE.md - Deployment and CI/CD for details.

License

See LICENSE file.