Platforms Starter Kit

Next.js Multi-Tenant Example

A production-ready example of a multi-tenant application built with Next.js 15, featuring custom subdomains for each tenant.

Features

• ✅ Custom subdomain routing with Next.js middleware
• ✅ Tenant-specific content and pages
• ✅ Shared components and layouts across tenants
• ✅ Redis for tenant data storage
• ✅ Admin interface for managing tenants
• ✅ Emoji support for tenant branding
• ✅ Support for local development with subdomains
• ✅ Compatible with Vercel preview deployments

Tech Stack

• Next.js 15 with App Router
• React 19
• Upstash Redis for data storage
• Tailwind 4 for styling
• shadcn/ui for the design system

Getting Started

Prerequisites

• Node.js 18.17.0 or later
• pnpm (recommended) or npm/yarn
• Upstash Redis account (for production)

Installation

1. Clone the repository:

   1
   git clone https://github.com/vercel/platforms.git
   2
   cd platforms

2. Install dependencies:

   1
   pnpm install

3. Set up environment variables: Create a .env.local file in the root directory with:

   1
   KV_REST_API_URL=your_redis_url
   2
   KV_REST_API_TOKEN=your_redis_token

4. Start the development server:

   1
   pnpm dev

5. Access the application:

   • Main site: http://localhost:3000
   • Admin panel: http://localhost:3000/admin
   • Tenants: http://[tenant-name].localhost:3000

Multi-Tenant Architecture

This application demonstrates a subdomain-based multi-tenant architecture where:

• Each tenant gets their own subdomain (tenant.yourdomain.com)
• The middleware handles routing requests to the correct tenant
• Tenant data is stored in Redis using a subdomain:{name} key pattern
• The main domain hosts the landing page and admin interface
• Subdomains are dynamically mapped to tenant-specific content

The middleware (middleware.ts) intelligently detects subdomains across various environments (local development, production, and Vercel preview deployments).

Deployment

This application is designed to be deployed on Vercel. To deploy:

1. Push your repository to GitHub
2. Connect your repository to Vercel
3. Configure environment variables
4. Deploy

For custom domains, make sure to:

1. Add your root domain to Vercel
2. Set up a wildcard DNS record (*.yourdomain.com) on Vercel