posta/web
0
0
Fork 0
Code Issues Pull requests Projects Releases 1 Packages Wiki Activity
No description
7 commits 1 branch 1 tag 110 KiB
  • CSS 40.3%
  • HTML 33.1%
  • Go 15.5%
  • Shell 11.1%
Find a file
Exact
Arne Skaar Fismen 018048354b
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
Details
add stamp mark, swap brand chip to use it 
Old-school postage stamp: perforated edges, engraved double-rule
border, "POSTA" letter-spaced across the top, italic Newsreader 'p'
as the centerpiece. Forest-deep + terracotta on a paper-warm face,
paper-deep field around it. Single 1024x1024 SVG source — convert
text to paths before using as the iOS app icon if you want
bit-identical output across devices.

The brand chip in layout.html now points at /static/mark.svg
instead of the bare unicode star, and .brand-mark in style.css is
img sizing rather than text styling.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-09 12:32:00 +02:00
deploy bootstrap: use alpine/3.21 image (3.20 no longer in registry) 2026-05-09 10:27:16 +02:00
static add stamp mark, swap brand chip to use it 2026-05-09 12:32:00 +02:00
templates add stamp mark, swap brand chip to use it 2026-05-09 12:32:00 +02:00
.gitignore add CI build + push-deploy from Woodpecker to fismen 2026-05-09 08:57:50 +02:00
.woodpecker.yaml switch deploy to pull model: cron-driven updater on the container 2026-05-09 10:05:47 +02:00
go.mod initial commit 2026-05-09 08:44:17 +02:00
go.sum initial commit 2026-05-09 08:44:17 +02:00
main.go initial commit 2026-05-09 08:44:17 +02:00
README.md initial commit 2026-05-09 08:44:17 +02:00
SPEC.md finish posta rename: protocol identifiers, Go API, embedded SPEC 2026-05-09 08:46:47 +02:00

README.md

posta/web

The marketing/documentation site for posta, served by a single Go binary.

Layout

web/
├── main.go              HTTP server + spec-md cache
├── templates/
│   ├── layout.html      shared header/footer/nav
│   ├── index.html       /        — landing
│   ├── spec.html        /spec    — server-rendered SPEC.md
│   └── design.html      /design  — design system reference
├── static/
│   └── style.css        all visual decisions
└── go.mod

Templates and static files are embedded with embed.FS, so the binary is self-contained.

Run

go run . --listen :9495 --spec ../spec/SPEC.md

Flags:

  • --listen TCP listen address (default :9495).
  • --spec path to SPEC.md. Read on every request, re-rendered when mtime changes. Default ../spec/SPEC.md (assumes the posta/spec repo is a sibling).

How /spec works

  1. The handler asks specCache.render() for the current HTML + TOC.
  2. The cache stats SPEC.md. If mtime hasn't advanced, return the cached HTML. Otherwise re-read, re-parse with goldmark, walk the AST to collect h2 + h3 headings into a TOC, and cache.
  3. The template inlines the rendered HTML and the TOC list.

This means edit SPEC.md and refresh — no rebuild, no JS rendering, no external dependencies at runtime.

Code highlighting

Goldmark's chroma integration emits <span class="ch-…"> tokens. Visual mapping lives in static/style.css under the .ch-chroma rules — the classes are mapped to the project's cream/forest palette directly, so the spec's code blocks share the same look as the home page's quickstart.

Design system

/design documents the palette, type scale, components, and CSS tokens used across both this site and any future surfaces. Treat it as the canonical reference when adding pages.