Open source. Ready for your next idea.

Your idea. Your AI.
A stronger starting point.

Build the part that makes your product yours. Start with identity, users, files, email and infrastructure already connected — and a shared workflow that helps your AI assistant extend them with care.

Start building View on GitHub

C# / .NET 10 · Angular 22 · Aspire 13

Built for the way we build now

AI accelerates the code. Give it a foundation worth extending.

The first feature should not begin with another round of authentication, storage and infrastructure setup. AspireBoot brings those pieces together, with explicit rules for how new work fits in.

Describe the outcome

Explain what should happen, who can do it and what each person can see. Start with the behavior your product needs.

Build with shared context

Codex, Claude Code, Gemini CLI and GitHub Copilot follow the same six skills for backend, frontend, testing, security and performance.

Review a concrete delivery

Ask for working behavior and relevant checks. Review the code and verification results as you evolve your application.

AGENTS.md + .agents/skills

From idea to a feature request

Codex · Claude Code
Gemini CLI · GitHub Copilot

A starting prompt for your assistant

Follow the project's instructions.

Customers can create orders with a description and a
positive amount, see only their own orders, and receive
an email when they confirm an order.

Keep the same look and feel as the rest of the app.
Ask me if any detail is unclear. Check that everything
works and each customer only sees their own orders.

Connected from the first run

Every part of the stack has a role.

From the browser to background delivery, the template connects these tools through existing features and shared conventions.

Application & interface

A responsive browser app and an API with explicit contracts.

.NET 10

ASP.NET Core Minimal APIs

Angular 22

Standalone components · signals · RxJS

Tailwind CSS 4

Responsive UI · light and dark themes

Scalar

OpenAPI reference in Development

Data & identity

Persistence, account protection and revocable sessions.

PostgreSQL

Application data · Identity · durable messages

Entity Framework Core

Npgsql · repositories · migrations

ASP.NET Core Identity

Accounts · roles · secure cookies

Redis

Cache · session tickets · email limits

Messaging & delivery

Durable events connect account actions to background work.

Wolverine

Transactional Outbox/Inbox · retries

RabbitMQ

Durable queues · event transport

SMTP / MailKit

Asynchronous email · external SMTP service

RustFS / S3

Private avatars · temporary signed URLs

Runtime & quality

Local orchestration, telemetry and checks across the application.

Aspire 13

AppHost · service wiring · dashboard

Caddy

HTTPS routing · production static files

OpenTelemetry

Logs · traces · metrics · health checks

xUnit / Testcontainers

Backend unit tests · real-container integration

Vitest / Angular TestBed

Frontend tests · HTTP contracts · coverage

Good defaults. Explicit boundaries.

Move faster with the essentials already considered.

A working starting point for the details that are easy to postpone when you are excited about an idea.

Identity is more than a login form

ASP.NET Core Identity, HttpOnly / Secure / SameSite cookies, CSRF protection, password recovery and email confirmation.

Access belongs on the server

Owner and administrator rules, request limits, session expiration and revocation. Each response exposes the fields its reader may access.

Private files stay private

S3-compatible storage with private buckets, temporary URLs, server-side avatar validation and scheduled orphan cleanup.

Background work has a delivery strategy

Transactional Outbox/Inbox, RabbitMQ with Wolverine, retries and failed-message storage. Email delivery runs in the worker.

More product. Less assembly.

The everyday features are already connected.

Use the included account application as a working example, then extend the same patterns into your own domain.

Users & profiles

Directory, profile details, name and photo editing, with owner-aware actions.

Account & sessions

Email and password changes, access history, session management and account soft deletion.

A frontend with a point of view

Responsive Angular, signals, Tailwind, light / dark themes and English / Portuguese.

Data & asynchronous work

PostgreSQL and EF Core, Redis caching, events, audit processing and queued email.

Visibility from the first run

OpenTelemetry logs, traces and metrics, health checks, Aspire dashboard and Scalar in Development.

A workflow you can verify

xUnit / Testcontainers, Angular Vitest tests and CI for builds, dependency audits and coverage.

One environment. Clear responsibilities.

See how the pieces connect.

Vertical Slice and Screaming Architecture organize the code by capability. Clean Architecture principles separate HTTP contracts in Api, application behavior in Core, adapters in Infrastructure and event consumers in Worker. Aspire AppHost connects the local environment.

AspireBoot / system mapVertical Slice · Screaming Architecture · Clean Architecture · CQRS

AspireBoot.AppHost · local orchestration

01 / Browser request

AngularStandalone · signals

CaddyHTTPS · /api

AspireBoot.ApiMinimal APIs · Identity

Shared application boundaries

AspireBoot.CoreCommands · queries · validation · business rules

AspireBoot.InfrastructureRepositories · Identity stores · integration adapters

02 / Durable background delivery

PostgreSQLWolverine · Outbox

RabbitMQDurable events

AspireBoot.WorkerInbox · retriesEmail · user audits · avatar cleanup

Data, sessions & private files

PostgreSQLRedisRustFS / S3

ServiceDefaults → OpenTelemetry · health · resilience

Worker → SMTP / MailKitExternal email service

Arrows show request and event flow. Api and Worker use Core and Infrastructure. SMTP is supplied separately.

Explore the architecture in the repository

Make it your starting point

Bring your idea. The foundation is here.

Get the source, prepare your local environment and launch the AppHost. Then describe the first feature you want to build.

Download source Full setup guide

Local prerequisites

.NET SDK 10.0.403 · Node.js 26.x · npm 12.2.1 · Docker-compatible runtime · mkcert · SMTP service

git clone https://github.com/crisbraatz/AspireBoot.git
cd AspireBoot

# Full setup guide: README.md
dotnet run --project AspireBoot.AppHost \
  --launch-profile https

Follow the README to install dependencies, create trusted local certificates and configure SMTP before starting. AppHost orchestrates the local stack. You can also run the services independently.

A few things worth knowing

Is this an AI app generator?

It is an open-source application foundation with shared instructions and a feature-delivery workflow for coding assistants. You bring your assistant and review what it builds.

Can I deploy it as soon as I download it?

Prepare production configuration first: secrets, HTTPS, SMTP, private storage, migrations, backups and the deployment topology. The README includes a before-deployment checklist.

Your idea. Your AI.A stronger starting point.