Search by

ethernick / statamic-activitypub-core

ethernick

ActivityPub federation addon for Statamic 5.x and 6.x

Package info

github.com/ethernick/statamic-activitypub-core

Documentation

Type:statamic-addon

pkg:composer/ethernick/statamic-activitypub-core

Statistics

Installs: 4

Dependents: 3

Suggesters: 0

Stars: 0

Open Issues: 0

v0.9.0 2026-11-02 15:51 UTC

This package is auto-updated.

Last update: 2026-11-20 19:48:11 UTC


README

ActivityPub Core for Statamic

Statamic 5 & 6 Version PHP 8.2+ ActivityPub Protocol Commercial License

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
Statamic ActivityPub Inbox Feed Statamic ActivityPub Create New Note
Federation Activities Stream Actor Lookup & Webfinger Discovery
Statamic ActivityPub Activities Stream Statamic ActivityPub Actor Lookup
ActivtyPub Addon Settings Job Queue
Statamic ActivityPub Settings Management Statamic ActivityPub Job Queue

🧩 Extension Addons

ActivityPub Core is built to be modular. Expand functionality with dedicated first-party or third-party addons:

Looking to build your own custom type? Check out the Extension Developer Guide (HOOKS.md).

📚 Documentation & Guides

🤝 Community & Support

📄 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.