> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aspfox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# What is AspFox

> A .NET 8 SaaS boilerplate that scaffolds a complete, renamed, production-ready application in two commands.

AspFox is a .NET 8 SaaS boilerplate sold as a one-time purchase. You install a `dotnet new` template, run one scaffold command, and get a complete multi-tenant SaaS application with your project name on every file, namespace, and assembly. Open it in Visual Studio or Rider, fill in environment variables, run Docker Compose, and you have a working application at localhost within an hour.

This is not a tutorial, not a demo project, and not a set of code snippets you assemble yourself. It is a production-ready codebase with real architectural decisions already made — Clean Architecture, CQRS with MediatR, row-level multi-tenant isolation, JWT RS256 auth, Stripe billing, Hangfire background jobs, and a complete React frontend. The decisions are baked in. You start from a running application and build your product on top of it.

The value is the code you do not have to write: email verification, refresh token rotation with reuse detection, cross-tenant data isolation, Stripe checkout and webhook handling, idempotent webhook processing, an admin panel with impersonation, background jobs for trial expiry and subscription reconciliation, a command palette, dark mode, and a notification system. None of that is placeholder. All of it works on day one.

## What is included

<CardGroup cols={2}>
  <Card title="Authentication" icon="lock" href="/core-concepts/authentication">
    Email/password with verification, JWT RS256 with rotating refresh tokens and reuse detection, Google and GitHub OAuth, passwordless magic links, forgot/reset password, and hardened endpoints that resist email enumeration.
  </Card>

  <Card title="Multi-Tenancy" icon="building" href="/core-concepts/multi-tenancy">
    Row-level tenant isolation enforced by EF Core global query filters — not just an API check. Tenant switching without re-authentication, slug generation, and a complete invitation flow with 72-hour expiry.
  </Card>

  <Card title="Stripe Billing" icon="credit-card" href="/core-concepts/stripe-billing">
    Three plans (Free / Pro / Business) with 14-day free trials. Stripe Checkout, customer billing portal, idempotent webhook processing for five events, subscription status cached in Redis, and manual admin override.
  </Card>

  <Card title="Admin Panel" icon="shield" href="/core-concepts/architecture">
    User and tenant management, subscription overview, user impersonation with a persistent red banner, soft delete, manual subscription status toggle, and a full audit log on every action.
  </Card>

  <Card title="Dark Mode + Cmd+K" icon="moon" href="/core-concepts/dark-mode-theming">
    System preference detection, manual override, CSS variable theming throughout. Command palette with navigation, permission-gated actions, and theme switching — opens with Cmd+K or Ctrl+K.
  </Card>

  <Card title="Notification System" icon="bell" href="/core-concepts/notifications">
    In-app notifications with unread count badge, 30-second polling, Redis-cached counts, and nine notification types triggered automatically by backend events. Full tenant isolation enforced.
  </Card>
</CardGroup>

## What you get

**A downloadable `.nupkg` template file.** After purchase you receive a download link. Download `AspFox.Templates.1.x.x.nupkg` to your machine, install it with `dotnet new install ./AspFox.Templates.1.x.x.nupkg`, and scaffold your project with `dotnet new aspfox -n YourProjectName`. Every namespace, file name, assembly name, and project reference says `YourProjectName` — not `AspFox`. You own the code from the moment you scaffold.

**A running application within an hour of purchase.** Scaffold, configure a `.env` file, run `make up && make migrate && make seed`, and open `http://localhost:5173`.

**This documentation.** Every feature in the boilerplate is documented here — what it does, how it is built, how to configure it, and how to extend it.

**All v1.x updates.** When a new version is released, you receive a new download link. Download the updated `.nupkg` and run `dotnet new install ./AspFox.Templates.1.x.x.nupkg` to update the template. Updates apply to the template for new scaffolds, not to your already-scaffolded project.

## What AspFox is not

<Warning>
  Read this section before purchasing if you have any uncertainty about what you are buying.
</Warning>

* **Not a subscription service.** One payment, \$179, no recurring charges.
* **Not a hosted platform.** You deploy to your own infrastructure.
* **Not access to a GitHub repository.** You receive a downloadable `.nupkg` file. You never see the source git history or the private repository.
* **Not a tutorial or learning resource.** AspFox assumes you know .NET and React. It is scaffolding, not education.
* **Not a managed service.** You are responsible for your deployment, database backups, and infrastructure.

## Get started

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/getting-started/quickstart">
    From purchase to running application in eight steps.
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/aspfox/aspfox">
    Public repo with issue tracker and README.
  </Card>
</CardGroup>