Platforms Starter Kit

Next.js Multi-Tenant Example

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

Features

• ✅ Custom subdomain routing with Next.js proxy
• ✅ 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 16 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 20.9.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 proxy 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 proxy (proxy.ts, the Next.js 16 replacement for 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