Skip to content

Organizations

Organizations are the core multi-tenant boundary in NuxtBase.

The template does not treat “team” as a vague UI label. It has a concrete organization model with:

  • a current active organization on the session
  • organization-scoped membership and roles
  • invitations sent by managers
  • optional sub-groups called teams
  • organization-aware permission checks on both client and server
  • organization creation and active workspace selection
  • role-aware access boundaries
  • invitation and acceptance flows
  • teams as sub-groups inside an organization
  • organization-scoped product behavior

Before changing this area, decide:

  1. what counts as a workspace in your product
  2. which roles are required at launch
  3. how invitations should behave
  4. what data must always stay organization-scoped

Some organization behavior exists immediately, even on a fresh install:

  1. a newly created user gets a default personal organization
  2. that user becomes the owner
  3. the session stores an activeOrganizationId
  4. protected product flows assume an active organization exists

This is why organizations are not an add-on module in NuxtBase. They are part of the base product model.

Multi-tenant logic touches routing, permissions, billing, and admin operations. Change it carefully and keep those systems aligned.