listmonk-static

Custom listmonk system static files: public pages, system e-mail templates, and locale strings. These replace the files bundled with listmonk when you point the binary at this directory (see the listmonk docs on system templates).

Layout

Path	Role
public/templates/	Public HTML (subscription, opt-in, archive, admin login shell, …)
public/static/	CSS, JS, logos, favicon, …
email-templates/	System e-mails (base.html, opt-in, import status, …)
i18n/	Locale JSON files (e.g. en.json)
renderer/	Small Go app to preview templates in a browser with mock data

Default color palette

Hex colors are inlined in email-templates/ and public/static/style.css; there is no shared token file. Swatches below match those defaults (classic e-mail templates use the cool gray backdrop; default-visual uses the warmer neutrals).

	Hex	Typical use
<title>Primary brand (trackit green)</title>	#1e5d39	Links, buttons, focus rings
<title>Link underline</title>	#5a7a6b	Link underline (public/ only)
<title>Error</title>	#ff6b35	Error text (public/ only)
<title>Page backdrop</title>	#f9f9f9	Public page background
<title>Email backdrop</title>	#F0F1F3	Classic e-mail outer background
<title>Visual backdrop</title>	#F5F5F5	Visual builder e-mail backdrop / footer blocks
<title>Shadow</title>	#f3f3f3	Input / card shadow tint
<title>Code block</title>	#f4f4f4	Code/pre background in classic templates (some files mistakenly use #f4f4f4f4)
<title>Surface</title>	#fff	Cards, content panels
<title>Divider</title>	#CCCCCC	Strong divider (visual e-mails)
<title>Light border</title>	#eee	Light borders, separators
<title>Input border</title>	#ddd	Inputs, borders
<title>Body text</title>	#444	Secondary labels, classic e-mail body copy
<title>Muted</title>	#666	Hints, archive dates
<title>Footer</title>	#888	Footer links, muted text
<title>Footer subtle</title>	#aaa	Public footer text
<title>Primary text</title>	#111	Primary body text, hovers
<title>Visual text</title>	#262626	Visual e-mail main text
<title>Dark bar</title>	#222	Dark header bar (some e-mails)
<title>Dark UI</title>	#333	Button hover, dark accents

Using with listmonk

Copy or mount this repo (or a subset) and start listmonk with your static path, for example:

listmonk --static-dir=/path/to/listmonk-static

Paths under public/ and email-templates/ match listmonk’s bundled layout so you can override only what you need.

Local template preview

To render the same templates without a full listmonk install, use the preview server in renderer/:

go run ./renderer
go run ./renderer -lang=de

The repo includes go.work so go run ./renderer works from the repository root. Then open the URL printed in the log (by default http://localhost:8088/) for an index of public and e-mail previews. Use -lang with the basename of any file in i18n/ (e.g. de, zh-CN; default en).

Language in listmonk

In the admin UI, set Settings → General → Language to the locale you want. listmonk loads the matching JSON from the static directory’s i18n/ folder (this repo’s i18n/ when using --static-dir here). Add or edit *.json files there to customize translations.