tenantpilot/README.md
2025-12-05 22:06:22 +01:00

1.2 KiB

TenantPilot

A multi-tenant SaaS application built with Next.js, Azure AD authentication, and Drizzle ORM.

Architecture Principles

This project follows strict architectural principles defined in our Constitution:

  • Server-First: Next.js App Router with Server Actions, no client-side fetches
  • Type Safety: TypeScript strict mode mandatory
  • Database: Drizzle ORM exclusively
  • UI: Shadcn UI components with Tailwind CSS
  • Auth: Azure AD multi-tenant authentication

Getting Started

First, install dependencies:

npm install

Copy environment variables:

cp .env.example .env

Fill in your Azure AD credentials and database URL.

Run database migrations:

npm run db:push

Start the development server:

npm run dev

Open http://localhost:3000 to see the application.

Development

  • Use Server Actions for all data operations
  • Follow TypeScript strict mode requirements
  • Use Shadcn UI for new components
  • Test with Azure AD authentication

Deployment

Build the Docker image:

docker build -t tenantpilot .

Run with environment variables:

docker run -p 3000:3000 --env-file .env tenantpilot