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

# 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:

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:

   STRIPE_SECRET_KEY=sk_test_...
   STRIPE_WEBHOOK_SECRET=whsec_...

3. Update BillingController.ts with Stripe checkout

License

MIT