Nuxt 3 Multi-tenancy

Nuxt 3 Multi-tenancy module for building multi-tenant applications on Nuxt 3

Features

⛰  Multi-tenancy Nuxt sites support by sub-domains

✨  A fully functional sample playground deployed on Vercel

Quick Setup

1. Add nuxt-multi-tenancy dependency to your project

# Using pnpm
pnpm add -D nuxt-multi-tenancy

# Using yarn
yarn add --dev nuxt-multi-tenancy

# Using npm
npm install --save-dev nuxt-multi-tenancy

2. Add nuxt-multi-tenancy to the modules section of nuxt.config.ts

export default defineNuxtConfig({
  modules: [
    'nuxt-multi-tenancy'
  ]
})

3. Create [site] folder under your Nuxt pages directory, you can check the playground's pages folder for referencing.

That's it! You can now use Nuxt Multi-tenancy in your Nuxt app ✨

Options

Configure Nuxt Multi-tenancy module with the multiTenancy property.

export default defineNuxtConfig({
  modules: ['nuxt-multi-tenancy'],
  // default options
  multiTenancy: {
    tenantDynamicRoute: 'site',
    rootDomains: ["nuxtdev.local", "nuxtdev.xyz"],
  },
})

useTenant composition API

Use useTenant() to get the tenant ID

import { useTenant } from '#imports'
const tenant = useTenant()

Development

# Install dependencies
yarn install

# Generate type stubs
yarn dev:prepare

# Develop with the playground
yarn dev

# Build the playground
yarn dev:build

# Run ESLint
yarn lint

# Run Vitest
yarn test
yarn test:watch

# Release new version
yarn release

Demo

You can view the demo at nuxtdev.xyz

Features:

• A home page to list top first 30 articles from dev.to
• Tenant detail page. For example: The Dev Team organization
• An article detail page

Contributing

• Open an issue if you believe you've encountered a bug with the module.

License

MIT License