{"id":18369960,"url":"https://github.com/statamic/collaboration","last_synced_at":"2025-10-04T07:00:04.389Z","repository":{"id":36946091,"uuid":"181017784","full_name":"statamic/collaboration","owner":"statamic","description":"Real-time, multi-user editing with Statamic via websockets","archived":false,"fork":false,"pushed_at":"2025-06-30T08:48:36.000Z","size":381,"stargazers_count":35,"open_issues_count":14,"forks_count":14,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-09-29T08:02:11.259Z","etag":null,"topics":["collaboration","collaborative-editing","multi-user","websockets"],"latest_commit_sha":null,"homepage":"https://statamic.com/addons/statamic/collaboration","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/statamic.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-04-12T13:51:55.000Z","updated_at":"2025-07-18T22:23:41.000Z","dependencies_parsed_at":"2024-11-05T23:36:15.843Z","dependency_job_id":"75185fb4-81c9-4f62-8b1d-e2e5c154fa97","html_url":"https://github.com/statamic/collaboration","commit_stats":{"total_commits":76,"total_committers":11,"mean_commits":6.909090909090909,"dds":0.2894736842105263,"last_synced_commit":"6d95f59a81a5192a9bf15e88d0d7f9d89ec7bdd1"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/statamic/collaboration","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/statamic%2Fcollaboration","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/statamic%2Fcollaboration/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/statamic%2Fcollaboration/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/statamic%2Fcollaboration/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/statamic","download_url":"https://codeload.github.com/statamic/collaboration/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/statamic%2Fcollaboration/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278277871,"owners_count":25960430,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["collaboration","collaborative-editing","multi-user","websockets"],"created_at":"2024-11-05T23:34:41.251Z","updated_at":"2025-10-04T07:00:04.367Z","avatar_url":"https://github.com/statamic.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- statamic:hide --\u003e\n# Collaboration\n\n\u003e Real-time collaboration and multi-user authoring for Statamic Pro.\n\u003c!-- /statamic:hide --\u003e\n\n## Features\n\n- Presence indicators when multiple people have the same entry opened.\n- Fields get locked when someone else focuses them.\n- Updates to field values are reflected to everyone.\n\n## Installation\n\nYou can install and configure the Collaboration addon using a single command:\n\n```\nphp please install:collaboration\n```\n\nThe command will install the `statamic/collaboration` addon, setup Laravel's broadcast scaffolding and prompt you to select which broadcast driver you wish to use.\n\nFor more information on the specifics for each broadcast driver, please review the following:\n\n### Laravel Reverb\n\nThe `install:collaboration` command will install Laravel Reverb into your application. After installation, run `php artisan reverb:start` to run Reverb's WebSockets server, then the Collaboration addon should start working in the Control Panel.\n\nWhen you deploy your application to a server, you will need to run the Reverb WebSockets server as a daemon (`php artisan reverb:start`). If you're using Laravel Forge, there's a Reverb toggle in your site's \"Application\" panel.\n\nFor further information on Reverb, please review the [Laravel documentation](https://laravel.com/docs/master/reverb#introduction).\n\n### Pusher\n\nThe `install:collaboration` command will install [Pusher](https://pusher.com/)'s PHP SDK into your application. After installation, you should add your Pusher credentials to your `.env` file:\n\n```\nPUSHER_APP_ID=\"your-pusher-app-id\"\nPUSHER_APP_KEY=\"your-pusher-key\"\nPUSHER_APP_SECRET=\"your-pusher-secret\"\nPUSHER_HOST=\nPUSHER_PORT=443\nPUSHER_SCHEME=\"https\"\nPUSHER_APP_CLUSTER=\"mt1\"\n```\n\nYou should also ensure you have enabled the \"Client Events\" setting (found under the \"App Settings\" page in the Pusher Dashboard).\n\n### Other\n\nIf you're planning on using a different broadcasting driver, there are a few additional steps you'll need to take to get it working:\n\n1. Install \u0026 configure your broadcasting driver (obviously)\n2. Update the `BROADCAST_DRIVER` in your `.env`\n3. Create a `resources/js/cp.js` file and add it to the Control Panel.\n    * [For more information, follow this guide on our documentation site](https://statamic.dev/extending/control-panel#adding-css-and-js-assets).\n4. In your `resources/js/cp.js` file, register a callback to override Statamic's [Echo](https://laravel.com/docs/10.x/broadcasting#client-side-installation) config:\n\n```js\nStatamic.booting(() =\u003e {\n    Statamic.$echo.config(() =\u003e ({\n        broadcaster: \"pusher\",\n        key: Statamic.$config.get('broadcasting.pusher.key'),\n        cluster: Statamic.$config.get('broadcasting.pusher.cluster'),\n        wsHost: Statamic.$config.get('broadcasting.pusher.host'),\n        wsPort: Statamic.$config.get('broadcasting.pusher.port'),\n        wssPort: Statamic.$config.get('broadcasting.pusher.port'),\n        forceTLS: false,\n        encrypted: true,\n        disableStats: true,\n        enabledTransports: [\"ws\", \"wss\"],\n    }));\n});\n```\n\n## Configuration\n\n### Sound Effects\n\nBy default, the Collaboration addon plays sound effects when other users join \u0026 leave entries.\n\nIf you wish to disable these, you may publish the configuration file (via `php artisan vendor:publish --tag=collaboration`) and set `sound_effects` to `false`.\n\n```php\n// config/collaboration.php\n\nreturn [\n    'sound_effects' =\u003e false,\n];\n```\n\n## Advanced Usage\n\nWhen the [\"meta data\"](https://statamic.dev/extending/fieldtypes#meta-data) of a fieldtype is updated, it will be broadcast to the other users in the channel. If you have a fieldtype that contains a large amount of meta data, and it gets updated (some may just provide initial state and never change), you may consider specifying the fields that should be broadcast. This could help keep message sizes smaller and improve performance.\n\nIn your fieldtype's `preload` method, you can use the special `__collaboration` key to list the fields.\n\n``` php\npublic function preload()\n{\n    return [\n        'hello' =\u003e 'world',\n        'foo' =\u003e 'bar',\n        '__collaboration' =\u003e ['foo'],\n    ];\n}\n```\n\nWhen the meta data gets updated, only the `foo` value will be broadcast. The remaining values will get merged in automatically.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstatamic%2Fcollaboration","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstatamic%2Fcollaboration","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstatamic%2Fcollaboration/lists"}