llm-wiki-governance-web

The official website for LLM-WIKI Governance, an open-source CLI that adds review states, source citations and change checks to the project docs AI coding agents write and read.

한국어

• Live site: https://dowon-kim7949.github.io/llm-wiki-governance-web/
• Product facts are pinned to v1.42.0 (commit 7bb943f). See docs/PRODUCT_CLAIMS.md.
• This repository contains only the website. The CLI lives in Dowon-Kim7949/llm-wiki-governance.

Stack

Next.js 16 (App Router, static export) · React 19 · TypeScript · GSAP ScrollTrigger ? CSS Modules · GitHub Pages via GitHub Actions. No backend, no database, no tracking.

Develop

npm ci
npm run dev          # http://localhost:3000/ko/
npm run lint && npm run typecheck && npm test
npm run build        # writes out/

Browser tests (Python 3.10+):

pip install playwright==1.56.0 Pillow && python -m playwright install chromium
npm run build && npm run serve &      # http://localhost:4173/
SITE_URL=http://localhost:4173 python tests/e2e/run_e2e.py

Layout

src/app/[lang]/     locale root layout + the page (ko, en)
src/components/     Experience (page shell), story/ (persistent viewport narrative + optional demo), CopyButton, LangSwitch; legacy scenes/ and figure/ retained
src/lib/            demo.ts (the demo repository: files, docs, citations), playground.ts (impact model), gsap.ts
src/content/        ko.ts, en.ts (typed dictionaries), story.ts (six-scene bilingual narrative), transcripts.ts (real CLI output, quoted line for line)
scripts/            postbuild (/ and 404), static server, OG image renderer, CLI captures (capture-demo.sh, capture-playground.sh)
docs/evidence/      raw v1.42.0 output the site quotes
tests/unit/         content parity, claim checks, quoted output and the playground model against the evidence
tests/e2e/          Playwright browser suite
docs/               design, product claims, testing, deployment

Docs

• Current stage redesign: architecture, recording observations, six scenes and verification
• Typography and responsive refinement: Jalnan Gothic provenance, layout measurements and before/after verification
• Previous visual redesign: historical asset direction and prompt
• Earlier design: historical brief and directions
• Product claims: every factual claim and how it was verified
• Testing and accessibility
• Deployment

Licence

Website code: MIT (LICENSE). Korean display headings use the official, unmodified Jalnan Gothic Regular under GC COMPANY's font licence; its copyright notice and complete usage guide ship in public/fonts/. Body text and English retain Archivo (OFL-1.1) and system Korean fonts. Fonts are self-hosted by next/font. The previous IBM Plex Sans KR subset is retained as a legacy asset. The main sculpture is an original generated bitmap; interface icons are SVG. See docs/THIRD_PARTY.md.