whilesmart/eloquent-workspaces

Workspace management package for Laravel applications

1.0.3 2026-06-11 19:35 UTC

Requires

• php: ^8.2
• cviebrock/eloquent-sluggable: ^12.0
• laravel/framework: ^12.0
• laravel/sanctum: ^4.0
• whilesmart/eloquent-roles: *

Requires (Dev)

• fakerphp/faker: ^1.24
• laravel/pint: ^1.22
• nunomaduro/collision: ^8.8
• orchestra/testbench: ^10.4
• zircote/swagger-php: ^5.1

Suggests

• whilesmart/organizations: For organization/customer management within workspaces
• whilesmart/projects: For project management within workspaces

MIT

• WhileSmart

README

A comprehensive Laravel package for managing workspaces, invitations, and member roles.

Quick Start

composer require whilesmart/eloquent-workspaces
php artisan migrate

That's it! The package will auto-register routes and work out of the box.

Environment Variables

All package configuration is environment-driven. Add these variables to your .env file:

Core Settings

# The user model class that will be used for workspace relationships.
WORKSPACES_USER_MODEL=App\\Models\\User

# The workspace model class. Point this at your own subclass (extending the
# base Workspace model) to compose extra traits/behaviour; it is honoured by
# the HasWorkspaces relations, role-context queries, and route-model binding.
WORKSPACES_MODEL=App\\Models\\Workspace

# Enable or disable route registration (default: true)
WORKSPACES_REGISTER_ROUTES=true

# Route prefix for all workspace endpoints (default: api)
WORKSPACES_ROUTE_PREFIX=api

Custom workspace model

// config/workspaces.php
'workspace_model' => App\Models\Workspace::class,

use Whilesmart\Workspaces\Models\Workspace as BaseWorkspace;

class Workspace extends BaseWorkspace
{
    // compose your own capabilities (HasInvoices, HasBrands, Configurable, …)
}

With this set, $user->workspaces(), currentOrDefaultWorkspace(), route-bound {workspace} params, and role checks all return / use your subclass — no re-resolving in the host app.

Workspace Settings

# Automatically create a personal workspace for a user on registration (default: true)
WORKSPACES_AUTO_CREATE=true

Invitation Settings

# Number of days an invitation is valid (default: 7)
WORKSPACES_INVITATION_EXPIRY=7

Advanced Configuration

For more advanced configuration, you can publish the configuration file:

php artisan vendor:publish --tag="workspaces-config"

This will create a config/workspaces.php file in your application.

route_middleware

You can specify middleware for the workspace routes.

'route_middleware' => ['auth:sanctum'],

personal_workspace_name_template

This template is used to name the personal workspace created for a new user. Available variables: {first_name}, {last_name}, {full_name}

'personal_workspace_name_template' => "{first_name}'s Workspace",

roles

Define the roles available in a workspace.

'roles' => [
    'owner' => 'owner',
    'admin' => 'admin',
    'member' => 'member',
],

Available Endpoints

• GET /api/workspaces/{workspaceId} - Get a workspace
• PUT /api/workspaces/{workspaceId} - Update a workspace
• GET /api/workspaces/{workspaceId}/members - Get workspace members
• POST /api/workspaces/{workspaceId}/members/invite - Invite a member to a workspace
• DELETE /api/workspaces/{workspaceId}/members/{userId} - Remove a member from a workspace

Events

This package does not currently dispatch any custom events.

Publishing Assets

You can publish the package's assets using the following commands:

# Publish only configuration
php artisan vendor:publish --tag="workspaces-config"

# Publish only migrations
php artisan vendor:publish --tag="workspaces-migrations"

# Publish everything
php artisan vendor:publish --provider="Whilesmart\\Workspaces\\WorkspacesServiceProvider"

License

This project is licensed under the MIT License - see the LICENSE file for details.