npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@micelio/strapi-plugin-fediverse

v0.7.1

Published

Micelio's fediverse federation (ActivityPub) as a Strapi 5 plugin.

Readme

Micelio Plugin Fediverse

Micelio's fediverse federation (ActivityPub) as a Strapi 5 plugin.

This is the plugin that ran inside micelio-cms as src/plugins/fediverse, moved out of the CMS in the cut-over of ADR-0017. It is released on npm as @micelio/strapi-plugin-fediverse from 0.7.0; this is the 0.7 line, which declares "micelio": "0.7" (the Micelio release line it belongs to). The release notes and the upgrade steps from the plugin inside micelio-cms are in docs/operate/upgrade-0.7.md.

What it needs from the host

The plugin reads and writes content types it does not own, so a host provides them:

  • @micelio/strapi-plugin-core (the default site, where the actor's profile and the object type live), strapi-plugin-comments (fediverse replies are stored as comments) and Strapi's i18n.
  • api::article.article (title, slug, description, cover, coverCredit, seo, category, tags) and the single type api::global.global (siteName, siteDescription, favicon).
  • The comments plugin extended with fediverseUri, fediverseActorHandle, fediverseNoteUri and fediverseNoteRetracted, and a middleware that hides PENDING and REJECTED comments from its public API. test/app/ is a minimal host that does all of it.

Install and enable

  1. Install the package at an exact version, with the plugins it builds on (see above) already in the host:

    npm install --save-exact @micelio/[email protected]

    The peer range of @micelio/strapi-plugin-core is ^0.2.0 || ^0.4.0; the suites run on 0.4.0 and, by hand, on 0.2.0.

  2. List it in config/plugins.ts as always enabled. The plugin reads FEDIVERSE_ENABLED itself, so its admin code is bundled whatever the variable is when the admin is built:

    export default () => ({
      fediverse: { enabled: true },
    })
  3. Set the variables of .env.example: FEDIVERSE_ENABLED=true, FEDIVERSE_ACTOR_IDENTIFIER (the actor's address; never change it afterwards), URL (the public origin of Strapi) and FRONTEND_URL. Set proxy: { koa: true } in config/server behind a TLS-terminating proxy.

  4. Build the admin and start Strapi. The page is Fediverse under Site in the Micelio sub-navigation. The host's root admin app does not register it: the package's ./strapi-admin entry does. Content Manager → Sites → your site → Fediverse holds the profile (username, display name, summary, source URL, header); the site's Hosts hold the handle host (the first one).

  5. Check that GET /.well-known/webfinger?resource=acct:<user>@<handle host> answers 200 on the site's domain (the frontend's route serves it) and read docs/operate/configure.md for the rest (the delivery queue, what to check after enabling).

Configuration

The plugin is named fediverse, so its content types are plugin::fediverse.follower, .interaction and .federated-article, and its permission actions plugin::fediverse.read and .manage. Each row of the three belongs to a site (site, a required relation made by withSiteScope of @micelio/strapi-plugin-core) and each site has its own actor key; see Sites and, to upgrade, docs/operate/configure.md. A host lists it in config/plugins.ts as always enabled, as test/app/config/plugins.js does: the plugin reads FEDIVERSE_ENABLED itself, so its admin code is bundled whatever the variable is when the admin is built. The variables are in .env.example:

| Variable | Default | Purpose | | ---------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | | FEDIVERSE_ENABLED | false | Read by the plugin. Off: no routes, content types or permissions, and an empty plugin. | | FEDIVERSE_ACTOR_IDENTIFIER | required | Path of the default site's actor URI. Never change it: remote servers key the account and its followers by that URI. | | URL | http://localhost:1337 | Strapi's public origin. Activity ids built outside a request come from it. | | FRONTEND_URL | required in production; http://localhost:3000 otherwise | Origin of the human-facing article links. | | FRONTEND_ARTICLE_PATH | /blog/{slug} | Article path template. | | FRONTEND_DEFAULT_LOCALE | en | Deprecated: the site's Default locale is read first; this only when the site has none. | | ENCRYPTION_KEY | required | Strapi's own: the actor's private key is stored encrypted with it. |

The variables FEDIVERSE_ACTOR_USERNAME, FEDIVERSE_ACTOR_NAME, FEDIVERSE_ACTOR_SUMMARY and FEDIVERSE_ACTOR_SOURCE_URL are removed: a boot with one set stops, naming the field of the default site that replaces it (server/src/utils/removed-variables.ts). FEDIVERSE_HANDLE_HOST and the attribution list are dropped in 0.7 for the site's hosts (the first 0.7 boot pins your handle host as the first one; remove the variable afterwards), and FRONTEND_DEFAULT_LOCALE is deprecated for the site's Default locale. Kept: FEDIVERSE_ENABLED, FEDIVERSE_ACTOR_IDENTIFIER, URL, FRONTEND_URL, FRONTEND_ARTICLE_PATH and ENCRYPTION_KEY. Details: docs/operate/upgrade-0.7.md.

Documentation

The documents are in docs/, filed by reader: how federation works (contributors), the public routes (integrators), configuring a host (operators, including what the host provides), and the log lines and keys of the plugin.

Getting started

npm ci
npm run check

npm run check builds the plugin (dist/strapi-server.js, one esbuild bundle: Fedify is ESM only and Strapi's CommonJS build cannot load it) and runs the suites, which boot a clean Strapi on SQLite with the plugin installed (test/app/). npm pack ships that bundle as the ./strapi-server export.

Conventions, commands and structure are in AGENTS.md; the rules every Micelio repository shares are in the engineering standard. To contribute, read CONTRIBUTING.md.

Releases

The Release workflow (.github/workflows/release.yml) is started by the maintainer from the Actions tab. It defaults to a dry run that prints the version and the notes. Publishing needs a release environment with required reviewers (Settings → Environments), and a pull request title with a conventional prefix decides the version (section 7 of the standard). Publishing also publishes the package to npm with provenance (npm-root: true, with the NPM_TOKEN secret of the release environment). The breaking_changes and upgrade_notes inputs are required when a pull request since the last release is breaking.

License

AGPL-3.0-only. Third-party material is listed in THIRD-PARTY.md.