ethernick / statamic-activitypub-core
ActivityPub federation addon for Statamic 5.x and 6.x
Package info
github.com/ethernick/statamic-activitypub-core
Type:statamic-addon
pkg:composer/ethernick/statamic-activitypub-core
Requires
- php: ^8.2
- embed/embed: ^4.4
- illuminate/contracts: ^11.0 | ^12.0
- illuminate/support: ^11.0 | ^12.0
- landrok/activitypub: ^0.8.1
- statamic/cms: ^5.0 | ^6.0
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Note
Pre-Release:
ActivityPub Core is feature-complete and ready to share and debate ahead of official marketplace listing. Free for local development and non-production testing under our Commercial Source-Available License.
Turn your Statamic site into a fully federated ActivityPub actor. Seamlessly syndicate content to Mastodon, Pixelfed, Threads, and the broader Fediverse while receiving follows, likes, replies, and boosts directly inside your Statamic Control Panel.
✨ Features at a Glance
| Feature | Description |
|---|---|
| 📡 Two-Way Federation | Syndicate notes and articles to followers across the Fediverse. Inbound replies, likes, boosts, and follows sync directly back to your site. |
| 🛡️ Secure HTTP Signatures | Cryptographic verification via RSA-SHA256 (Signature and Digest headers) with strict clock-skew mitigation (±300s window). |
| ⚡ Zero-Bloat Sidecar Storage | ActivityPub JSON documents are stored in clean .json sidecars alongside flat-file Markdown entries, keeping the Statamic Stache blazing fast. |
| 📬 Native Control Panel Inbox | Rich interactive stream feed built for both Statamic 5 (Vue 2.7) and Statamic 6 (Vue 3.5) with real-time interaction states. |
| 🎛️ Background Queue Worker | Non-blocking distribution with dedicated retry loops, backoff handling, and dead-letter queue (DLQ) tracking via activitypub-outbox. |
| 🚫 Self-Healing & Auto-Block | Domain and handle-based blocklists with automated auto-blocking on 410 Gone and instance suspension detection. |
| 🧩 Modular Addon Ecosystem | Easily extendable via the ActivityPubTypes service registry to support polls, long-form articles, places, or custom schemas. |
🚀 Quick Start
1. Require Package via Composer
composer require ethernick/statamic-activitypub-core
2. Publish Configuration & Assets
php artisan vendor:publish --tag=activitypub-config php artisan vendor:publish --tag=activitypub-assets
3. Run Queue Worker
Federation outbox distribution runs asynchronously via Laravel's queue. Ensure your queue worker processes the activitypub-outbox queue:
php artisan queue:work --queue=activitypub-outbox,default
🏛️ System Architecture
graph LR
subgraph StatamicCP [Statamic Control Panel]
Author[Creator / Editor] -->|Publish Entry| EntrySaved[EntrySaved Event]
InboxFeed[ActivityPub Inbox] <--|Read| InboundCache[Federated Entries]
end
subgraph CoreEngine [ActivityPub Core Engine]
EntrySaved --> SidecarGen[Generate Sidecar .json]
SidecarGen --> DispatchPost[Dispatch SendActivityPubPost]
DispatchPost --> Queue[(Queue: activitypub-outbox)]
end
subgraph Fediverse [Decentralized Fediverse]
Queue -->|Signed HTTP POST| RemoteInboxes[Mastodon / Pixelfed / Threads]
RemoteInboxes -->|Signed Inbound Activity| SharedInbox["/activitypub/sharedInbox"]
end
SharedInbox --> SignatureAuth[Verify HTTP Signature]
SignatureAuth --> InboundCache
Loading
🖼️ Control Panel Experience
| Federated Inbox Feed | Create New Note |
|---|---|
![]() |
![]() |
| Federation Activities Stream | Actor Lookup & Webfinger Discovery |
|---|---|
![]() |
![]() |
| ActivtyPub Addon Settings | Job Queue |
|---|---|
![]() |
![]() |
🧩 Extension Addons
ActivityPub Core is built to be modular. Expand functionality with dedicated first-party or third-party addons:
- ActivityPub Questions — Adds interactive Fediverse polls and question voting widgets.
- ActivityPub Places — Adds location check-ins and
Placemetadata federation. - ActivityPub Events — Adds event calendar & rsvp attendance
Eventmetadata federation.
Looking to build your own custom type? Check out the Extension Developer Guide (HOOKS.md).
📚 Documentation & Guides
- Production Operator & Installation Guide — Step-by-step installation, Supervisor queue setup, and web server (Nginx/Apache/Caddy/Cloudflare) configs.
- Troubleshooting & Operations Runbook — Diagnostic matrix for Webfinger, HTTP signatures, clock skew, and stuck queues.
- Federation Best Practices & Performance Guide — Actor topologies, auto-block moderation, Redis/DB queues, and retention policies.
- Extension Developer Guide — Registry APIs, lifecycle store hooks, outbox formatters, and Vue injection points.
- Frontend Build System — Dual-bundle Vue 2 (Statamic 5) and Vue 3 (Statamic 6) architecture.
- Marketplace Launch Blueprint — Creative specs, screenshot guides, 15-second video storyboard, and creator onboarding materials.
- Task Roadmap & Release Checklist — Active development punch-list and marketplace release milestones.
- Product Requirements Document — Architectural decisions, domain models, and technical history.
🤝 Community & Support
- Bug Reports & Feature Requests: Issue Tracker
- Source Code Repository: Repository
- Documentation: Project Documentation
📄 License
ActivityPub Core for Statamic is source-available software provided under the Statamic Commercial License (free for local development and non-production testing; requires a commercial license for production deployments).
🦾 AI Disclosure
Parts were written with the help of AI agents including Gemini & Claude.






