Minimal

Minimal v1.3.0

Sans-serif, plenty of whitespace and a single blue accent — goblog's minimal theme.

Screenshot of Minimal

Version: 1.3.0 (released 2026-10-03)
Author: Jason Ernst
License: Apache-2.0
Source: https://github.com/goblogplatform/goblog-theme-minimal
Requires: goblog 0.14.0 or newer
Download: https://github.com/goblogplatform/goblog-theme-minimal/archive/refs/tags/v1.3.0.zip
content hash e6e355bfdc2ea617bec915a3bd6cb93f68690cb4429716a4124584e1a43ce51c

Install it from your own goblog under Admin → Themes.

README

Minimal — a goblog theme

Sans-serif, plenty of whitespace and a single blue accent. This is the theme that shipped compiled into goblog as minimal up to 0.6.x, published as a directory theme so it can be installed and updated on its own.

Install

From your goblog: Admin → Themes → Browse → Minimal → Install, then Activate. Requires goblog 0.7.0 or newer (earlier releases have a built-in minimal that shadows an installed copy).

Upgrading a site that already used the built-in minimal: after the goblog upgrade the site renders the default theme until you install Minimal from the directory; the theme setting is left alone, so the site switches back as soon as the theme is installed.

What it overrides

Only the public-facing templates that differ from default (header, footer, home, post, posts, login and the page_* types) and static/css/goblog.css. Everything else — admin and wizard pages, tags, archives, search, error — renders from goblog's default theme, so it keeps up with new goblog releases automatically.

Developing

Edit the files under templates/ and static/, drop the folder into a goblog checkout as themes/installed/minimal/ (or point THEMES_INSTALLED_DIR at its parent) and set the theme setting to minimal. Templates are Go html/template; see goblog.live/docs/writing-a-theme for the contract.

Releasing

Tag vX.Y.Z and publish a GitHub release; the directory picks up the tag's archive. screenshot.png at the root is shown in the listing.

Changelog

1.3.0

The login page offers goblog's password form (the shared _password_login partial) when the site has a password account, under the GitHub button. Until now a site with both GitHub login and a password admin showed only GitHub on this theme (goblog #666).
Requires goblog 0.14.0, the first release with password login and the partial.

1.2.0

The footer's "Powered by goblog" line comes from goblog's shared _powered_by partial instead of being written out in the theme. It now links to goblog.live rather than the GitHub repository, and a site can hide it with the Show "Powered by goblog" setting under Admin → Settings → Appearance (goblog #644).
Requires goblog 0.13.0, the first release with the partial; on anything older the theme's footer.html references a template that does not exist.

1.1.0

Signing in with GitHub is goblog's job now. The button is a plain link to /login/github; the theme no longer assembles the authorize URL in an inline script, where window.location went into redirect_uri unescaped, nor handles the ?code= that came back. goblog completes the exchange server-side against a state it minted, so a code obtained for one account can no longer be replayed into another visitor's browser (goblog #631, #637).
The button's own URL comes from the server too, as .github_login_url, instead of being built with a template conditional in every theme (goblog #639).
The email login posts to /api/login/email directly rather than rebuilding the site's origin first.
Requires goblog 0.12.0, and the manifest now says so, so the installer refuses the combination rather than installing a theme whose sign-in button has no URL to point at. Upgrade goblog first. An older version of this theme still signs in on 0.12.0 — goblog restarts the flow when a callback arrives with no state (goblog #640) — but it gets there via a second round trip to GitHub, so update the theme rather than relying on that.

Note that this theme still renders markdown in the browser; goblog 0.10.0 moved that to the server for the other themes but it has not been ported here (#2).

1.0.1

Inline scripts that call jQuery and highlight.js wait for DOMContentLoaded, so the theme keeps working when goblog defers its CDN scripts (goblog 0.11.0, goblogplatform/GoBlog#624). Without this, posts lose syntax highlighting, the GitHub login button does nothing and the post body is never inserted.
The GitHub login button's href is set during parse with document.getElementById(...).href instead of jQuery, so the link is never briefly inert.
Backward compatible: still works on older goblog.

1.0.0

First release as a directory theme: the public templates and CSS of the minimal theme that was compiled into goblog up to 0.6.x, layered on goblog's default theme.

Releases

v1.3.0 2026-10-03

Requires goblog 0.14.0.

What's changed

The login page offers goblog's password form (the shared _password_login partial) under the GitHub button when the site has a password account, the admin account goblog 0.14.0's install wizard creates. Until now a site with both GitHub login and a password admin showed only GitHub on this theme (goblogplatform/GoBlog#666).

Upgrading

min_goblog_version is now 0.14.0, so the directory offers this only once your goblog is on that release. Upgrade goblog first.

v1.2.0 2026-10-03

Requires goblog 0.13.0.

What's changed

The footer's "Powered by goblog" line comes from goblog's shared _powered_by partial instead of being written out in the theme. It now links to goblog.live rather than the GitHub repository, and a site can hide it with the Show "Powered by goblog" setting under Admin → Settings → Appearance (goblogplatform/GoBlog#644).

Upgrading

min_goblog_version is now 0.13.0, the first release with the partial, so the directory offers this only once your goblog is on that release.

Upgrade goblog first. On anything older the theme's footer.html references a template that does not exist.

v1.1.0 2026-09-26

Requires goblog 0.12.0.

What's changed

Signing in with GitHub is goblog's job now. The button is a plain link to /login/github; the theme no longer assembles the authorize URL in an inline script — where window.location went into redirect_uri unescaped — nor handles the ?code= that came back. goblog completes the exchange server-side against a state it minted, so a code obtained for one account can no longer be replayed into another visitor's browser (goblogplatform/GoBlog#631, #637).

The button's own URL comes from the server too, as .github_login_url, rather than being built with a nested template conditional in every theme (goblogplatform/GoBlog#639).

The email login posts to /api/login/email directly rather than rebuilding the site's origin first.

Upgrading

min_goblog_version is now 0.12.0, so the directory offers this only once your goblog is on that release.

Upgrade goblog first. On 0.12.0 an older version of this theme still signs in, because goblog restarts the flow when a callback arrives with no state (goblogplatform/GoBlog#640), but it gets there via a second round trip to GitHub.

Note

This theme still renders markdown in the browser. goblog 0.10.0 moved that to the server for the other themes; porting it here is tracked in #2.

v1.0.1 2026-09-23

Prepares the theme for goblog 0.11.0, which loads its CDN scripts with defer (goblogplatform/GoBlog#624).

What's changed

With defer, jQuery and highlight.js are not defined while the page is still parsing, so inline scripts that called them during parse would throw — no syntax highlighting, a dead GitHub login button, and a post body that never gets inserted. Those calls now wait for DOMContentLoaded.

footer.html — hljs.highlightAll()
login.html — the ?code= exchange and the email login form wiring
login.html — the GitHub button's href is set with document.getElementById(...).href during parse now, so it is never briefly inert and needs no library
post.html — the $("#html") call that inserts the rendered post

post.html still builds its converter during parse: the comment loop and previewComment() read that global, and showdown/DOMPurify are local body scripts that are not deferred.

Compatibility

Install this before upgrading to goblog 0.11.0. A DOMContentLoaded handler behaves the same whether or not the scripts are deferred, so this release also works on older goblog — min_goblog_version is unchanged at 0.7.0.

Note

This theme still renders markdown in the browser. goblog 0.10.0 moved that to the server for the other themes but it was never ported here — tracked in #2.

v1.0.0 2026-09-22

First release as a directory theme: the public templates and CSS of the minimal theme compiled into goblog up to 0.6.x, layered on goblog's default theme. Requires goblog 0.7.0 or newer.