Skip to content

AI-ready reference architecture for Angular / ASP.NET Core projects. A hardened foundation with secure authentication, authorization, role and user management, and consistent patterns designed to be safely extended by AI tools. Stop letting AI hallucinate your auth and DB logic - give it a production-grade foundation to build on.

License

Notifications You must be signed in to change notification settings

emonney/QuickApp

Repository files navigation

QuickApp - The AI-Ready Reference Architecture for Angular 21 / ASP.NET Core 10 Projects

MIT license VSIX Downloads Twitter Follow

A hardened full-stack foundation designed to be safely extended by AI.

QuickApp is an opinionated Angular 21 + ASP.NET Core 10 starter that solves the boring, fragile, and security-sensitive parts of modern web applications so that AI tools (ChatGPT, Copilot, Claude, Cursor, etc.) can safely build on top of it.

Stop letting AI hallucinate your Auth and DB logic—give it a production-grade foundation to build on.

QuickApp Demo

LIVE DEMO | Video Demo


Why QuickApp Exists (in the Age of AI)

AI can generate code fast. It is also very good at:

  • ✅ Generating new features
  • ✅ Repeating existing patterns
  • ✅ Filling in CRUD features
  • ✅ Extending UI and API layers

AI is not good at:

  • ❌ Designing secure authentication flows
  • ❌ Maintaining architectural consistency over time
  • ❌ Enforcing authorization rules correctly
  • ❌ Making long-lived projects stable

QuickApp provides a known-good foundation where those hard problems are already solved. You start with QuickApp, then let AI extend the application inside guardrails.

Think of it as:

The boring, correct core that lets AI do the exciting work without breaking everything.


How QuickApp Makes AI Development 10x More Reliable

AI-Optimized Foundation

QuickApp provides a standardized foundation that gives your chosen AI a set of "Laws" to follow. The AI's output becomes 10x more reliable because it isn't guessing the infrastructure; it's just filling in the features.

Architectural Governance

  • Secure auth already done correctly - OpenIddict/OAuth2 with JWT tokens, refresh token handling, and proper claims management
  • Authorization patterns already enforced - Role and permission-based policies with custom authorization handlers
  • Error handling, logging, validation already wired - Centralized patterns that AI-generated code automatically inherits
  • Consistent structure - One obvious way to add features, making AI prompts predictable

AI then fills in features inside these guardrails, not by inventing new patterns.

Designed to be Extended via AI Prompts

QuickApp is intentionally structured so AI tools can extend it safely and predictably:

  • Explicit patterns - BaseEntity, BaseApiController, EndpointBase service patterns that AI can follow
  • Predictable folder structure - Controllers, Services, ViewModels, Components organized consistently
  • One preferred way - Clear conventions reduce AI guesswork

AI performs best when the rules are clear. QuickApp makes the rules boring and obvious.


What You Get Out of the Box

Backend (ASP.NET Core 10)

  • JWT-based authentication with OpenIddict/OAuth2
  • Role and permission-based authorization with custom policies and handlers
  • Clean API layering - BaseApiController with consistent error handling
  • DTO patterns - AutoMapper integration for ViewModels
  • Centralized validation - Model sanitization and error handling
  • Entity Framework Core - Code First migrations with audit trails
  • Repository and Unit of Work patterns - Structured data access
  • Swagger/OpenAPI - Auto-generated API documentation
  • Logging and configuration - Already wired and ready

Frontend (Angular 21)

  • Authentication and authorization guards - Route protection built-in
  • User and role management UI - Complete admin interface
  • Consistent service patterns - EndpointBase with automatic token refresh
  • Structured component architecture - Standalone components with lazy loading
  • Bootstrap 5 theming - Responsive design out of the box
  • Internationalization - Multi-language support
  • Token management - Automatic refresh token handling

Architecture

  • Opinionated but extensible - Clear patterns, easy to extend
  • One obvious way - Reduces decision fatigue
  • AI-friendly patterns - Structure that AI tools can reliably follow

How to Use QuickApp with AI

1. Start from QuickApp

# Clone the repository
git clone https://github.com/emonney/QuickApp.git
cd QuickApp

# Restore dependencies
dotnet restore
cd quickapp.client
npm install

# Run the application
# Backend: F5 or dotnet run
# Frontend: npm start

Verify authentication, roles, and base features work.

2. Let AI Extend It

Use prompts like:

"Add a new Invoice entity following the existing Product pattern (API, DTO, Angular service, and UI)."

"Add role-based access so only Admin users can create or delete invoices."

"Create a new Angular component for invoice management that matches the existing customers component structure."

3. Review, Not Reinvent

  • AI fills in features following QuickApp's patterns
  • QuickApp ensures structure, security, and consistency
  • You review and refine, not rebuild from scratch

Why This Works

  • Patterns are explicit - BaseEntity, BaseApiController, EndpointBase show AI exactly what to follow
  • Folder structure is predictable - Controllers, Services, ViewModels, Components in expected places
  • There is one preferred way - Less ambiguity = better AI output

What This Project Is (and Is Not)

QuickApp is:

  • ✅ A production-ready foundation
  • ✅ A stable substrate for AI code generation
  • ✅ A reference architecture you can trust
  • ✅ Guardrails instead of scaffolding
  • ✅ The perfect context-base for Claude, Copilot, and Cursor

QuickApp is not:

  • ❌ A replacement for AI tools
  • ❌ A magic generator that writes your entire app
  • ❌ A one-click solution for every use case
  • ❌ Just another starter template

Who This Is For

  • 🎯 Developers using AI to accelerate full-stack development
  • 🎯 Teams that want speed without architectural chaos
  • 🎯 Solo developers who don't trust AI with auth and security
  • 🎯 Enterprise projects that need predictable structure
  • 🎯 Anyone tired of AI-generated codebases that slowly collapse under their own weight

Installation

Option 1: Clone from Git

git clone https://github.com/emonney/QuickApp.git

Option 2: Visual Studio Template

Install from the Visual Studio Marketplace and use File → New Project → Web → QuickApp.

Setup Steps

  1. Restore dependencies:

    # Backend
    dotnet restore
    
    # Frontend
    cd quickapp.client
    npm install
  2. Configure database connection in appsettings.json

  3. Run migrations:

    dotnet ef database update
  4. Launch:

    • Backend: F5 or dotnet run from QuickApp.Server
    • Frontend: npm start from quickapp.client

Default Login Credentials

Administrator Account:

  • Username: admin
  • Email: admin@ebenmonney.com
  • Password: tempP@ss123

Standard Account:

  • Username: user
  • Email: user@ebenmonney.com
  • Password: tempP@ss123

Note: Change these passwords immediately in production!


Prompting Guidelines for AI Tools

Quick Start

Always include this in your AI prompts:

Reference the AI rules files in the ai-rules/ folder:
- ai-rules/AI_RULES_BACKEND.md for ASP.NET Core backend patterns
- ai-rules/AI_RULES_FRONTEND.md for Angular frontend patterns
- ai-rules/AI_RULES_OVERVIEW.md for quick reference

Follow the exact patterns and conventions documented in these files.

Detailed Guidelines

When using AI tools with QuickApp, reference existing patterns explicitly:

  • "Reference ai-rules/AI_RULES_BACKEND.md" - Comprehensive backend patterns and rules
  • "Reference ai-rules/AI_RULES_FRONTEND.md" - Complete Angular frontend patterns
  • "Follow the existing entity pattern" - Reference Product.cs or Customer.cs
  • "Match the authorization approach used in Users" - Point to UserAccountController.cs
  • "Reuse the Angular service and component conventions" - Reference AccountEndpoint or CustomersComponent
  • "Use the same DTO pattern as ProductVM" - Show the ViewModel structure
  • "Follow the BaseApiController error handling pattern" - Reference the base controller

Example Prompt

Add a new Invoice entity with full CRUD operations following QuickApp patterns.

Reference:
- ai-rules/AI_RULES_BACKEND.md for backend patterns
- ai-rules/AI_RULES_FRONTEND.md for frontend patterns

Create:
1. Entity (Invoice.cs) inheriting BaseEntity
2. ViewModel (InvoiceVM.cs) with validator
3. Service interface and implementation
4. Controller with CRUD endpoints
5. AutoMapper configuration
6. Angular model interface
7. Angular endpoint service
8. Angular component with list view
9. Route configuration

Follow the exact patterns from Customer/Product examples.

Clear prompts + stable foundation + comprehensive rules = fewer rewrites.


Technical Stack

Backend

  • ASP.NET Core 10 - Cross-platform web framework
  • Entity Framework Core - Code First ORM
  • OpenIddict - OAuth2/OIDC authentication
  • AutoMapper - Object-to-object mapping
  • Swagger/OpenAPI - API documentation

Frontend

  • Angular 21 - Modern web framework
  • TypeScript - Type-safe JavaScript
  • Bootstrap 5 - Responsive UI framework
  • RxJS - Reactive programming

Philosophy

QuickApp embraces AI-assisted development without pretending AI replaces engineering discipline.

The goal is simple:

  • Humans decide architecture - You choose QuickApp's patterns
  • QuickApp enforces it - Structure and security are built-in
  • AI does the repetitive work - Features, CRUD, UI components

Stable architecture that resists AI-generated spaghetti.

Minimizes rework when AI code gets it half-right.


Additional Resources

Premium Versions

Documentation

Support


Contribution

QuickApp is actively maintained on GitHub. You can support it by:


License

Released under the MIT License.


If you are tired of AI-generated codebases that slowly collapse under their own weight, start from something solid.

YOUR FEEDBACK | FOLLOW ME


If you found this template useful, please take a minute to rate it. Appreciated!

About

AI-ready reference architecture for Angular / ASP.NET Core projects. A hardened foundation with secure authentication, authorization, role and user management, and consistent patterns designed to be safely extended by AI tools. Stop letting AI hallucinate your auth and DB logic - give it a production-grade foundation to build on.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published