PHPackages                             apermo/sovereignty - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. apermo/sovereignty

ActiveWordpress-theme

apermo/sovereignty
==================

Pure Zen - Fork of Pfefferle's Autonomie Theme

2.0.1(1w ago)07[24 issues](https://github.com/apermo/sovereignty/issues)[1 PRs](https://github.com/apermo/sovereignty/pulls)MITPHPPHP &gt;=8.3CI passing

Since Jan 27Pushed 1w agoCompare

[ Source](https://github.com/apermo/sovereignty)[ Packagist](https://packagist.org/packages/apermo/sovereignty)[ Docs](https://github.com/apermo/sovereignty)[ RSS](/packages/apermo-sovereignty/feed)WikiDiscussions main Synced today

READMEChangelog (10)Dependencies (67)Versions (26)Used By (0)

Sovereignty
===========

[](#sovereignty)

A semantic, responsive WordPress theme with deep IndieWeb support. Fork of [Autonomie](https://github.com/pfefferle/Autonomie) by Matthias Pfefferle.

Requirements
------------

[](#requirements)

- PHP 8.3+
- WordPress 6.4+

Installation
------------

[](#installation)

```
composer require apermo/sovereignty
```

Or download the latest release from [GitHub](https://github.com/apermo/sovereignty/releases).

### Building assets after a Composer install

[](#building-assets-after-a-composer-install)

Compiled CSS is **not** committed to the repository — it is generated from the SCSS sources by `npm run build`. After installing via Composer in a Bedrock-style project, run the build inside the theme directory:

```
cd web/app/themes/sovereignty
npm ci
npm run build
```

In a GitHub Actions deploy workflow, the same step is available as a reusable composite action:

```
- uses: apermo/sovereignty/.github/actions/build@v1.4.2
  with:
      working-directory: web/app/themes/sovereignty
```

Development
-----------

[](#development)

### Prerequisites

[](#prerequisites)

- Node.js + npm
- PHP 8.3+ with Composer
- [DDEV](https://ddev.com/) (for local testing)

### Quick Start

[](#quick-start)

```
./bin/install.sh --dev   # Install dependencies + build CSS
ddev start && ddev orchestrate   # Set up local WordPress
```

### Build

[](#build)

```
npm run build            # Compile SASS, inject metadata, generate minified CSS
npm run build:sass       # SASS only (no placeholders/minification)
npm run watch            # Watch SCSS and recompile on change
```

### Lint

[](#lint)

```
composer cs              # PHPCS (errors only)
composer cs:fix          # Auto-fix PHP issues
composer analyse         # PHPStan (level 5)
npm run lint:js          # ESLint
npm run lint:css         # Stylelint
```

### Test

[](#test)

```
composer test:unit       # PHPUnit (73 unit tests)
npx playwright test      # E2E tests (31 tests, requires DDEV)
```

### E2E Tests

[](#e2e-tests)

```
ddev start && ddev orchestrate
npx playwright test
```

Architecture
------------

[](#architecture)

The theme uses namespaced PHP classes under `Apermo\Sovereignty\` with PSR-4 autoloading:

```
src/
├── Theme.php              # Hook registration (entry point)
├── Config.php             # theme.json config loader
├── Setup.php              # Theme supports, nav menus
├── Assets.php             # Script/style enqueue
├── Semantics.php          # Microformats2, Schema.org
├── Featured_Image.php     # Post thumbnails, post covers
├── Feed.php               # RSS/Atom extensions
├── Template/              # Template tags and helpers
├── Integration/           # Plugin integrations
└── Widget/                # Custom widgets

```

Configuration is centralized in `theme.json` with standard WordPress settings and a custom `sovereignty` section. The `sovereignty_config` filter allows per-site overrides in multisite.

Supported Plugins
-----------------

[](#supported-plugins)

- [ActivityPub](https://wordpress.org/plugins/activitypub/)
- [Post Kinds](https://wordpress.org/plugins/indieweb-post-kinds/)
- [Syndication Links](https://wordpress.org/plugins/syndication-links/)

Web Semantics
-------------

[](#web-semantics)

The theme markup uses microformats, microformats2, and microdata (Schema.org):

### Microformats (v1)

[](#microformats-v1)

- [hAtom](http://microformats.org/wiki/hatom)
- [hCard](http://microformats.org/wiki/hcard)
- [rel-tag](http://microformats.org/wiki/rel-tag)
- [XFN](http://microformats.org/wiki/xfn)

### Microformats2

[](#microformats2)

- [h-feed](http://microformats.org/wiki/h-feed) / [h-entry](http://microformats.org/wiki/h-entry)
- [h-card](http://microformats.org/wiki/h-card)

### Microdata (Schema.org)

[](#microdata-schemaorg)

- [Blog](https://schema.org/Blog)
- [BlogPosting](https://schema.org/BlogPosting)
- [Comment](https://schema.org/Comment)
- [WebPage](https://schema.org/WebPage)
- [Person](https://schema.org/Person)

### IndieWeb

[](#indieweb)

- [Webactions](https://indieweb.org/webactions) — reply, like, and repost actions across sites

License
-------

[](#license)

MIT License — see [LICENSE](LICENSE) for details.

Copyright (c) 2018-2025 Matthias Pfefferle Copyright (c) 2025-2026 Christoph Daum

### Bundled Resources

[](#bundled-resources)

- Some Bootstrap CSS, Copyright Twitter, Inc., The Bootstrap Authors — MIT
- [OpenWeb Icons](https://pfefferle.dev/openwebicons/) — SIL OFL 1.1
- Bundled images (starter content), Copyright Hendrik Cvetko — GPL-2.0-or-later

###  Health Score

46

—

FairBetter than 92% of packages

Maintenance95

Actively maintained with recent releases

Popularity6

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 58.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~11 days

Recently: every ~4 days

Total

14

Last Release

12d ago

Major Versions

1.5.3 → 2.0.02026-06-15

PHP version history (2 changes)v1.0.0PHP &gt;=7.4.0

1.1.0PHP &gt;=8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/910b8010a35a86821d0b90d645374f5ae484513f2c195818e4c54bc0175d12e1?d=identicon)[apermo](/maintainers/apermo)

---

Top Contributors

[![pfefferle](https://avatars.githubusercontent.com/u/2373?v=4)](https://github.com/pfefferle "pfefferle (485 commits)")[![apermo](https://avatars.githubusercontent.com/u/4695889?v=4)](https://github.com/apermo "apermo (325 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (6 commits)")[![metbril](https://avatars.githubusercontent.com/u/559346?v=4)](https://github.com/metbril "metbril (4 commits)")[![mcleodchris](https://avatars.githubusercontent.com/u/35972784?v=4)](https://github.com/mcleodchris "mcleodchris (2 commits)")[![krafit](https://avatars.githubusercontent.com/u/1038789?v=4)](https://github.com/krafit "krafit (2 commits)")[![Ramoonus](https://avatars.githubusercontent.com/u/77956?v=4)](https://github.com/Ramoonus "Ramoonus (1 commits)")[![Ruxton](https://avatars.githubusercontent.com/u/382760?v=4)](https://github.com/Ruxton "Ruxton (1 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/apermo-sovereignty/health.svg)

```
[![Health](https://phpackages.com/badges/apermo-sovereignty/health.svg)](https://phpackages.com/packages/apermo-sovereignty)
```

###  Alternatives

[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.5k10](/packages/helsingborg-stad-municipio)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.1k17.8k](/packages/prestashop-prestashop)[october/rain

October Rain Library

1601.7M83](/packages/october-rain)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

45444.2k1](/packages/pressbooks-pressbooks)[drupal/recommended-project

Project template for Drupal projects with a relocated document root

1502.8M1](/packages/drupal-recommended-project)[mediawiki/maps

Adds various mapping features to MediaWiki

84152.3k3](/packages/mediawiki-maps)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
