feat: Teams support (#14)

* Data model changes for teams functionality

* Create personal team when creating a new user

* Update Team to use soft delete

* Refactor current/default team to align with Cloud approach

* Add events, notifications, policies and middleware for team feature

* Add actions and config for team feature

* Update structure for Teams files for Inertia kits

* Update build command, watch script, workflow and docs for Team feature

* Refactor Membership to remove polymorphic relationship and add user model config

* Add new layer for shared controllers for Inertia kits teams

* Add validation for team name to avoid reserved names

* Initial integration for Vue UI (Fortify)

* Refactor to deprecate teams actions and add default values for current team on URLs

* Refactor Team Switcher component

* Add feature test cases for Teams

* Improve Team deletion flow

* Small refactor to the watch script

* Update tests for changes in deletion

* Revert refactor for watch script

* Refactor team invitations

* Refactor team roles

* Add missing layout for WorkOS Teams

* Fix issues with dashboard route on WorkOS variant

* Refactor to use switchTeam from HasTeams

* Add isCurrentTeam helper method on HasTeams trait

* Remove not used method

* Fix issue with tests on WorkOS variant

* React teams feature implementation and team switcher added to header layout

* Livewire teams implementation

* Fix issue with tests for livewire team test

* Improvements to invites, permissions and team deletion

* General minor improvements

* Apply linter changes for Teams implementation

* Apply linter/formatter changes for Teams React implementation

* Update to Inertia globals and applied linter/formatter on Vue Teams implementation

* Apply linter/formatter changes for Teams Vue implementation

* Fix issue on removing needed changes

* Improve SKILL and create minimal guidelines files pointing to skill

* Updated watch script and components mapping for Svelte Teams

* Improve Skill and guidelines

* Organize GH actions

* Svelte Teams Feature implementation

* TeamSwitcher component refactor for React and Vue

* Update EnsureMembership.php

* Update SetTeamUrlDefaults.php

* formatting

* First batch of fixes for code  review

* Improved Pint configuration for Maestro and applied it in both orchestrator and kits

* Update empty constructors

* Another batch of changes for code review

* Lint workflow improvement

* Improved import lint rules

* Child routes fix and UI improvements

* Update how to handle titles in Livewire starter kits to match Inertia ones

* team settings styling

* Update Edit.vue

* Update index.tsx

* wip

* Update Index.svelte

* Update global.d.ts

* wip

* wip

* Linter changes

* Create UserTeam DTO

* Add TeamPermissions DTO

* Refactor dialog/modal components

* Applied Linter changes

* Fix tooltip for icons in Teams edit page

* Update agents skill file to match claude one

* Add teams variants for tests workflow

* Update check kit script to add teams variants

* Apply linter changes

* Apply sentence case to all user-facing text in Teams kits and align sidebar icon/title with base kits

* Update global types for teams

* wip

* dto method consistency and reduce number of queries

* Update HasTeams.php

* Update HasTeams.php

* Update TeamRole.php

* Update TeamController.php

* Update TeamInvitationController.php

* Update TeamMemberController.php

* Update TeamMemberController.php

* Update TeamMemberController.php

* Update app-header.tsx

* Update welcome.tsx

* eslint

* do not allow the team owner to remove themselves

* rely on assignable for updating team member

* tests

* typo

* Update TeamController.php

* Update TeamInvitationController.php

* ensure no stale data on non-happy path

* processing indicators for destructive actions

* use wayfinder object with verb instead of verb

* copy update

* Update TeamRole.php

* toUserTeams

* Update edit.blade.php

* no single line curlies

* fix variant counts, variant label, and docs after rebase

* Add missing config

* Update Pint config and apply linter changes

* Fix issue with invite modal

* formatting

* Refactor migrations and remove MembershipFactory

* Rename team invitation rule

* Updated invitation code to 64 chars

* Update Delete team flow

* formatting (#45)

* formatting

* remove need for config file

* test formatting

* working on livewire

* update livewire

* formatting

* Linter fixes

---------

Co-authored-by: Wendell Adriel <wendelladriel.ti@gmail.com>

* changes for security page on teams variants

* Add --teams to variant filtering flags in orchestrator scripts

The teams variants in check-kits and lint-kits were missing the
`variant` property, so they couldn't be targeted with the selective
execution flags. This adds `--teams` to the recognized variant flags
and tags all teams entries so they can be filtered independently.

* adjust method order on policy

* update invitation

* update Teams welcome page SVG to Laravel 13 illustration

* use Fillable and Hidden attributes on teams models

* restore Current badge and Star icon on teams index page

Replace the CheckCircle/Circle icon approach with a green "Current"
badge next to the team name and a Star icon button for switching teams,
matching the Livewire variant's existing UX across React, Svelte, and
Vue Inertia kits.

* remove current team badge and switch button from teams index page

Team switching is already available in the sidebar, so the redundant
"Current" badge and star switch button are no longer needed on the
teams list page. The "Personal" badge and edit/view buttons are kept.

* Add teams variants to CI test matrix

* Remove stale pr_branch fields from push workflow teams entries

* Align teams kits with Inertia 3 layout pattern

Teams pages were manually wrapping with AppLayout/SettingsLayout
instead of using the createInertiaApp layout callback. This converts
all teams pages (React, Vue, Svelte) to the declarative layout
property pattern matching non-teams kits, adds bootstrap overrides
with teams/ route handling, removes unnecessary .url from wayfinder
route helpers, and fixes pre-existing Svelte 5 type issues ($page
store syntax, currentUrl import path, missing isCurrentOrParentUrl).

* Add teams browser test suite and expand matrix to 8 variants

Introduces a dedicated browser test suite for Teams covering
registration, team CRUD, switching, invitations, member management,
and permission-based UI visibility across all four stacks.

Browser tests are reorganized into three layers (bootstrap, common,
teams) so each variant runs exactly one suite. The runner script and
CI workflow are expanded from 4 to 8 jobs accordingly.

Adds data-test selectors to the Teams UI across Livewire, React,
Svelte, and Vue. Renames the Livewire team-switcher wire:model from
"name" to "teamName" to avoid input name collisions with other pages
sharing the sidebar layout.

---------

Co-authored-by: Joe Tannenbaum <joe.tannenbaum@laravel.com>
Co-authored-by: Taylor Otwell <taylor@laravel.com>

Author: 3 people

.agents/skills/maestro/SKILL.md

@@ -20,15 +20,35 @@ jobs:
         include:
           - name: Livewire Kit
             kit: Livewire
+            teams: false
 
           - name: React Kit
             kit: React
+            teams: false
 
           - name: Svelte Kit
             kit: Svelte
+            teams: false
 
           - name: Vue Kit
             kit: Vue
+            teams: false
+
+          - name: Livewire Teams Kit
+            kit: Livewire
+            teams: true
+
+          - name: React Teams Kit
+            kit: React
+            teams: true
+
+          - name: Svelte Teams Kit
+            kit: Svelte
+            teams: true
+
+          - name: Vue Teams Kit
+            kit: Vue
+            teams: true
 
     steps:
       - name: Checkout Maestro
@@ -52,10 +72,13 @@ jobs:
 
       - name: Build ${{ matrix.name }}
         working-directory: orchestrator
-        run: php artisan build --kit=${{ matrix.kit }}
+        run: php artisan build --kit=${{ matrix.kit }}${{ matrix.teams && ' --teams' || '' }}
+
+      - name: Copy Browser Test Bootstrap to Build
+        run: cp -r browser_tests/bootstrap/* build/
 
-      - name: Copy Browser Tests to Build
-        run: cp -r browser_tests/* build/
+      - name: Copy Browser Test Suite to Build
+        run: cp -r browser_tests/${{ matrix.teams && 'teams' || 'common' }}/* build/
 
       - name: Install Build Composer Dependencies
         working-directory: build

.claude/skills/maestro/SKILL.md

@@ -50,6 +50,22 @@ jobs:
             branch: workos
             node: false
 
+          - name: Livewire Kit (Teams)
+            kit: Livewire
+            build_flags: '--teams'
+            repository: laravel/livewire-starter-kit
+            path: livewire-starter-kit-teams
+            branch: teams
+            node: false
+
+          - name: Livewire Kit (WorkOS Teams)
+            kit: Livewire
+            build_flags: '--teams --workos'
+            repository: laravel/livewire-starter-kit
+            path: livewire-starter-kit-workos-teams
+            branch: workos-teams
+            node: false
+
           # React variants
           - name: React Kit (Blank)
             kit: React
@@ -75,6 +91,22 @@ jobs:
             branch: workos
             node: true
 
+          - name: React Kit (Teams)
+            kit: React
+            build_flags: '--teams'
+            repository: laravel/react-starter-kit
+            path: react-starter-kit-teams
+            branch: teams
+            node: true
+
+          - name: React Kit (WorkOS Teams)
+            kit: React
+            build_flags: '--teams --workos'
+            repository: laravel/react-starter-kit
+            path: react-starter-kit-workos-teams
+            branch: workos-teams
+            node: true
+
           # Svelte variants
           - name: Svelte Kit (Blank)
             kit: Svelte
@@ -100,6 +132,22 @@ jobs:
             branch: workos
             node: true
 
+          - name: Svelte Kit (Teams)
+            kit: Svelte
+            build_flags: '--teams'
+            repository: laravel/svelte-starter-kit
+            path: svelte-starter-kit-teams
+            branch: teams
+            node: true
+
+          - name: Svelte Kit (WorkOS Teams)
+            kit: Svelte
+            build_flags: '--teams --workos'
+            repository: laravel/svelte-starter-kit
+            path: svelte-starter-kit-workos-teams
+            branch: workos-teams
+            node: true
+
           # Vue variants
           - name: Vue Kit (Blank)
             kit: Vue
@@ -125,6 +173,22 @@ jobs:
             branch: workos
             node: true
 
+          - name: Vue Kit (Teams)
+            kit: Vue
+            build_flags: '--teams'
+            repository: laravel/vue-starter-kit
+            path: vue-starter-kit-teams
+            branch: teams
+            node: true
+
+          - name: Vue Kit (WorkOS Teams)
+            kit: Vue
+            build_flags: '--workos --teams'
+            repository: laravel/vue-starter-kit
+            path: vue-starter-kit-workos-teams
+            branch: workos-teams
+            node: true
+
     steps:
       - name: Checkout Maestro
         uses: actions/checkout@v6

.github/workflows/browser-tests.yml

@@ -23,15 +23,23 @@ jobs:
           - Livewire Kit
           - Livewire Kit (Components)
           - Livewire Kit (WorkOS)
+          - Livewire Kit (Teams)
+          - Livewire Kit (WorkOS Teams)
           - React Kit (Blank)
           - React Kit
           - React Kit (WorkOS)
+          - React Kit (Teams)
+          - React Kit (WorkOS Teams)
           - Svelte Kit (Blank)
           - Svelte Kit
           - Svelte Kit (WorkOS)
+          - Svelte Kit (Teams)
+          - Svelte Kit (WorkOS Teams)
           - Vue Kit (Blank)
           - Vue Kit
           - Vue Kit (WorkOS)
+          - Vue Kit (Teams)
+          - Vue Kit (WorkOS Teams)
         include:
           # Livewire variants
           - name: Livewire Kit (Blank)
@@ -58,6 +66,18 @@ jobs:
             path: livewire-starter-kit-workos
             node: false
 
+          - name: Livewire Kit (Teams)
+            kit: Livewire
+            build_flags: '--teams'
+            path: livewire-starter-kit-teams
+            node: false
+
+          - name: Livewire Kit (WorkOS Teams)
+            kit: Livewire
+            build_flags: '--teams --workos'
+            path: livewire-starter-kit-workos-teams
+            node: false
+
           # React variants
           - name: React Kit (Blank)
             kit: React
@@ -77,6 +97,18 @@ jobs:
             path: react-starter-kit-workos
             node: true
 
+          - name: React Kit (Teams)
+            kit: React
+            build_flags: '--teams'
+            path: react-starter-kit-teams
+            node: true
+
+          - name: React Kit (WorkOS Teams)
+            kit: React
+            build_flags: '--teams --workos'
+            path: react-starter-kit-workos-teams
+            node: true
+
           # Svelte variants
           - name: Svelte Kit (Blank)
             kit: Svelte
@@ -96,6 +128,18 @@ jobs:
             path: svelte-starter-kit-workos
             node: true
 
+          - name: Svelte Kit (Teams)
+            kit: Svelte
+            build_flags: '--teams'
+            path: svelte-starter-kit-teams
+            node: true
+
+          - name: Svelte Kit (WorkOS Teams)
+            kit: Svelte
+            build_flags: '--teams --workos'
+            path: svelte-starter-kit-workos-teams
+            node: true
+
           # Vue variants
           - name: Vue Kit (Blank)
             kit: Vue
@@ -115,6 +159,18 @@ jobs:
             path: vue-starter-kit-workos
             node: true
 
+          - name: Vue Kit (Teams)
+            kit: Vue
+            build_flags: '--teams'
+            path: vue-starter-kit-teams
+            node: true
+
+          - name: Vue Kit (WorkOS Teams)
+            kit: Vue
+            build_flags: '--workos --teams'
+            path: vue-starter-kit-workos-teams
+            node: true
+
     steps:
       - name: Checkout Maestro
         uses: actions/checkout@v6

.github/workflows/push-kit-changes.yml

@@ -2,23 +2,23 @@
 
 Maestro is the monorepo orchestrator for the official Laravel starter kits. Use the local maestro skill before making changes:
 
-- **Skill**: `.claude/skills/maestro/SKILL.md` — project structure, commands, kit inheritance, placeholder system, and workflow rules.
+- **Skill**: `.claude/skills/maestro/SKILL.md` — project structure, commands, kit inheritance, teams feature, placeholder system, and workflow rules.
 
 ## Quick Reference
 
-- Build: `cd orchestrator && php artisan build` (interactive) or use `--kit`, `--blank`, `--workos`, flags
+- Build: `cd orchestrator && php artisan build` (interactive) or use `--kit`, `--blank`, `--workos`, `--teams` flags
 - Dev: `composer kit:run` (from `orchestrator/`)
 - Test: `composer setup && composer ci:check` (from `build/`)
-- Test all kits: `composer kits:check` (from `orchestrator/`) — builds and runs CI checks for all 13 variants
+- Test all kits: `composer kits:check` (from `orchestrator/`) — builds and runs CI checks for all 21 variants
 - Pint only: `composer kits:pint` (from `orchestrator/`) — runs Pint on `kits/` and `browser_tests/`
 - Lint: `composer kits:lint` (from `orchestrator/`) — runs `kits:pint`, then frontend lint/format for Inertia variants
-- Browser tests (all kits): `composer kits:browser-tests` (from `orchestrator/`)
+- Browser tests (all 8 kits): `composer kits:browser-tests` (from `orchestrator/`)
 - Edit in `build/` (when available), commit in `kits/`
 
 ### Selective Execution
 
 Pass `--livewire`, `--react`, `--svelte`, and/or `--vue` to target specific frameworks.
-Pass `--blank`, `--fortify`, `--workos`, and/or `--components` to target specific variants.
+Pass `--blank`, `--fortify`, `--workos`, `--components`, and/or `--teams` to target specific variants.
 Combine both to narrow down exactly which kit variants to run:
 
 ```bash

.github/workflows/tests.yml

@@ -2,23 +2,23 @@
 
 Maestro is the monorepo orchestrator for the official Laravel starter kits. Use the local maestro skill before making changes:
 
-- **Skill**: `.claude/skills/maestro/SKILL.md` — project structure, commands, kit inheritance, placeholder system, and workflow rules.
+- **Skill**: `.claude/skills/maestro/SKILL.md` — project structure, commands, kit inheritance, teams feature, placeholder system, and workflow rules.
 
 ## Quick Reference
 
-- Build: `cd orchestrator && php artisan build` (interactive) or use `--kit`, `--blank`, `--workos`, flags
+- Build: `cd orchestrator && php artisan build` (interactive) or use `--kit`, `--blank`, `--workos`, `--teams` flags
 - Dev: `composer kit:run` (from `orchestrator/`)
 - Test: `composer setup && composer ci:check` (from `build/`)
-- Test all kits: `composer kits:check` (from `orchestrator/`) — builds and runs CI checks for all 13 variants
+- Test all kits: `composer kits:check` (from `orchestrator/`) — builds and runs CI checks for all 21 variants
 - Pint only: `composer kits:pint` (from `orchestrator/`) — runs Pint on `kits/` and `browser_tests/`
 - Lint: `composer kits:lint` (from `orchestrator/`) — runs `kits:pint`, then frontend lint/format for Inertia variants
-- Browser tests (all kits): `composer kits:browser-tests` (from `orchestrator/`)
+- Browser tests (all 8 kits): `composer kits:browser-tests` (from `orchestrator/`)
 - Edit in `build/` (when available), commit in `kits/`
 
 ### Selective Execution
 
 Pass `--livewire`, `--react`, `--svelte`, and/or `--vue` to target specific frameworks.
-Pass `--blank`, `--fortify`, `--workos`, and/or `--components` to target specific variants.
+Pass `--blank`, `--fortify`, `--workos`, `--components`, and/or `--teams` to target specific variants.
 Combine both to narrow down exactly which kit variants to run:
 
 ```bash