Prototype index and acceptance checklist

Seko · sekokurd.org redevelopment

Design system and static HTML prototype for Seko, the Sorani-first intellectual review. Prepared by Komms Haus against the publication structure (8 Sep 2026) and the wireframes and prototype brief (9 Sep 2026), both under docs/briefs/.

What is here

Build and view

npm run build     # → dist/ (identical on every platform)
npm run icons     # macOS only: regenerate the committed raster icons after the mark changes (ADR 0018)
npm run cards     # render the missing or stale share cards (og:image, 1200 × 630 JPEG) with a local Chrome and commit them (ADR 0032); check fails until they are current
npm run deploy:preview  # build, check, upload to seko.pages.dev with noindex (ADR 0019); CI runs the same script after every merge to main (ADR 0025)
npm run serve     # http://localhost:4321/ — the prototype index is the root page
npm run check     # budget, links, landmarks, alt text, logical properties, HTML validation (html-validate)

Start at dist/index.html: it maps every screen and state in the brief to a URL, in Sorani (RTL), English (LTR) and the German Tier 3 sample, and links the documentation (tokens, components, RTL rule sheet, binding sheet, microcopy, card spec, design notes).

Regenerating assets (network needed): npm run import takes the export again, runs the discovery pass and re-selects the prototype set with portraits; npm run fonts fetches the Google-served subsets and python3 tools/merge-fonts.py, python3 tools/subset-variable.py <dir with variable TTFs> [output.woff2 …] and python3 tools/tighten-arabic.py produce the shipped files, and python3 tools/plex-arabic.py the IBM Plex Sans Arabic files for the prototype index (fontTools, brotli and uharfbuzz via pip); python3 tools/clean-portraits.py re-cuts the portrait set from the originals (numpy, opencv-python and Pillow via pip); python3 tools/make-mark.py outlines the wordmarks.

Working rules

CLAUDE.md states the standards the repo follows and how work is recorded: every non-trivial decision is an ADR in docs/decisions/, every session appends to docs/log/, CHANGELOG.md follows Keep a Changelog, commits follow Conventional Commits, and npm run check must pass before a commit. CONTRIBUTING.md has the checklist; LICENSE.md the terms per part of the repo.

Conventions

• Sorani is the origin: every component is drawn in RTL first and the LTR edition is the same template with dir and the type stack changed. Layout CSS uses logical properties only (the checker fails on physical ones).
• No page depends on script to show its text. seko.js is the only script and it only adds behaviour; controls it powers are hidden in the markup so no dead control is shown.
• Section colour on labels, rules, progress bar and row hover only; brand blue on links and focus; gold on dossier labels.
• The language model is visible where it acts: translation notices in three variants, the Tier 3 line, corrections that say what they corrected, and proposal chips on the editorial screens. Never "AI" in reader-facing text.
• URLs follow structure §6: /{edition}/{section}/{slug}/, native-script slugs for Arabic-script editions, localised system segments from one routing table.

Status

The prototype runs on Seko's real content: 32 articles selected from the 1007 in the export, the real contributors with their portraits and bios, the real About and Contact pages. English and German versions are machine translations published with the notice until an editor post-edits them. See docs/design-notes.md and the decision records; D1–D13 remain with the editors.