Installation

Require the package, then publish and run its migrations — and those of the Roundly packages it builds on. The service provider and the Teams facade alias are auto-discovered:

composer require roundly-consulting/teams-for-laravel

php artisan vendor:publish --tag="options-migrations"
php artisan vendor:publish --tag="contacts-migrations"
php artisan vendor:publish --tag="addresses-migrations"
php artisan vendor:publish --tag="connections-migrations"
php artisan vendor:publish --tag="approvals-migrations"
php artisan vendor:publish --tag="teams-migrations"
php artisan migrate

Publishing is required — none of these packages load their migrations themselves, so a bare php artisan migrate creates no tables. The six teams migrations publish timestamp-injected and in dependency order (teams first, then the tables whose foreign keys reference it), so they order correctly against your own. Republishing lands on the same files, so --force overwrites in place. Migrations only migrate forward: rolling them back leaves the tables in place.

Why the sibling migrations

Teams reads its per-team settings — join policy, seat cap, default role — from options-for-laravel on every member add and join request, so the options table is needed from the very first Teams::create(). The contacts, addresses, connections and approvals tables back Teams::for($team)->contacts(), ->addresses(), ->connections() and the governed join-request sign-off — see Integrations.

Optional publishing

php artisan vendor:publish --tag="teams-config"         # config/teams.php
php artisan vendor:publish --tag="teams-translations"   # error messages
php artisan vendor:publish --tag="teams-stubs"          # controller, routes, subscriber, Pest file

Before your first team

• Members with UUID or ULID keys? Set TEAMS_KEY_TYPE before you migrate — see Configuration.
• Add the HasTeams trait to your user model — see Model traits.
• Register your roles in a service provider, including the owner, admin and member keys the package assigns by default — see Roles.