Canx SaaS Starter

💼 SaaS application template with multi-tenancy, team management, and billing.

Features

- ✅ Multi-Tenancy - Subdomain/header-based tenant isolation
- ✅ Team Management - Invite members, assign roles
- ✅ Billing Ready - Subscription management, invoice history
- ✅ Authentication - Login/register with team creation
- ✅ Queue Dashboard - Built-in at /canx-queue

Quick Start

``bash

Clone the starter

bunx degit chandafa/canx-starters/saas my-saas

Install dependencies

cd my-saas
bun install

Start development server

bun run dev
`

Project Structure

`
src/
├── controllers/
│ ├── AuthController.ts # Login/register with team
│ ├── BillingController.ts # Subscription & invoices
│ ├── DashboardController.ts # Main dashboard
│ ├── HomeController.ts # Landing & pricing
│ └── TeamController.ts # Team management
├── middleware/
│ └── tenant.ts # Multi-tenancy middleware
├── views/
│ └── layouts/
│ └── saas.ts # App layout
├── routes.ts # Route definitions
└── app.ts # Application entry
`

Multi-Tenancy

Tenants are identified by:

1. Subdomain: acme.yourdomain.com → tenant: acme
2. Header: X-Tenant-Id: acme

Access tenant in controllers:

`typescript
const tenant = this.request.context.get("tenant");
console.log(tenant.id); // "acme"
`

Available Routes

| Route | Description |
| ---------------- | ----------------------- |
| / | Landing page |
| /pricing | Pricing page |
| /auth/login | Login |
| /auth/register | Register + create team |
| /dashboard | Main dashboard |
| /team | Team management |
| /billing | Subscription & invoices |

Stripe Integration

To integrate Stripe:

1. Install Stripe: bun add stripe
2. Set environment variables:
`env
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...
`
3. Update BillingController.ts` with Stripe checkout

License

MIT