gopherium /gophenberg

A plugin-first CMS. Go backend, React admin, Gutenberg editor.

★ 1,011⑂ 127👁 25⑃ 373● 312▤ 24
GoApache-2.0Created 2026-07-19
下载:Gophenberg 0.20.1Gophenberg-0.20.1 ↓0.20.12026-11-07
-1
日增长
1,011
stars
127
forks
25
watchers
373
prs
312
issues
24
releases

README

Gophenberg




A plugin-first CMS. Go backend exposing a JSON API, React SPA admin built on top of
the WPDS and Gutenberg block editor.

Documentation

 What works today

- Block content authored in the Gutenberg editor, with autosave, revisions, trash and
  restore
- A posts list with status filters, counts and sorting, and a trash view
- Content types registered from the admin, each with its own addresses, archive, and
  optional nesting
- A media library storing uploads with derived image sizes, feeding the editor's media
  blocks from a picker and the inserter
- Session authentication with login rate limiting, and a users screen for administrators
- A public site at the root, the admin under /admin, and a read-only content API at
  /api/content/v1
- Optional Astro themes through @gophenberg/astro, with the built-in renderer taking
  over whenever no theme is active or a theme is down
- Compile-time plugins owning routes, public paths, and their own schema, with a
  reference plugin serving the posts as an RSS channel

 Running it locally

Go as pinned in go.mod, Node 26 with pnpm, and Docker for the PostgreSQL service.

sh
cp .env.example .env
make seed


make seed starts PostgreSQL, applies the migrations, and creates a development
administrator ([email protected] with the password password1234) alongside demo
content. Then run the API and the admin in two terminals:

sh
make dev
pnpm install && pnpm --filter @gophenberg/frontend dev


The API listens on localhost:8081 and the admin on localhost:5174, which proxies
/api to the API.

To self-host a real deployment instead, follow the
install guide.

 Writing a theme

A theme is an Astro project depending on @gophenberg/astro. You write your layouts,
the kit supplies the routes and the block rendering. test/theme is a working example,
and writing a theme walks it.

 Writing a plugin

A plugin is a Go package under plugins/ with a plugin.json, compiled in by
make generate. plugins/feed is the reference, and
write a plugin walks it.

 Translating

The admin speaks whatever language its catalogues carry. Translation happens on
POEditor, no Git needed, and a
weekly job carries the finished work back in one batch.
Translate Gophenberg
walks it.

 License

Copyright (C) 2026 Manuel 'SirLouen' Camargo

Gophenberg is free and open-source software under the
Apache License 2.0. Hand-written source files carry an
SPDX-License-Identifier: Apache-2.0 header.

Built frontend artifacts bundle @wordpress/ packages licensed under
GPL-2.0-or-later. Those combined bundles are conveyed under the terms of the
GPLv3, while all original source files in this repository remain Apache-2.0.

Top issues

Discussions

Latest release

Gophenberg 0.20.1 v0.20.1 2026-11-07
The one-command install now runs on newer Ubuntu and Debian releases and shows what it is doing while it works.

 What's new

- The server install sets up Ubuntu 24.04 or newer and Debian 12 or newer. CI now tests it on Ubuntu 24.04 and 26.04.
- Each install step names the programs it runs, and prints a line every 30 seconds while one is slow, with what it last printed or why its last try failed.
- Keeping the server up to date says what updates itself, when to restart, and how to move to a new Ubuntu release and PostgreSQL version.

 Fixed

- The Updates screen says a long update keeps the si

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON