Files
CV_Site_Nuxt/OKF_Nuxt/index.md
T
Noel Sabia c626cc9c1d
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / Lint + typecheck (pull_request) Canceled after 45s
PR Check / Secret scan (gitleaks) (pull_request) Canceled after 0s
PR Check / Dependency audit (pull_request) Canceled after 0s
PR Check / Dockerfile lint (droast) (pull_request) Canceled after 0s
feat(ci): replace opencode review with PR-Agent
Run PR-Agent as a pinned webhook server on the Gitea Docker network and review on PR open plus slash commands. The per-PR opencode installer and verdict-posting step are removed.

The server-side .env stays outside the repository; deploy/pr-agent/ holds the compose definition and operator notes.
2026-10-30 21:00:53 +01:00

4.0 KiB

okf_version
okf_version
0.2

Start here

This bundle explains the Nuxt repository: how it is developed, checked, released, and what was learned getting there. It is the "why" behind the config files — the configs say what, these documents say why.

  • Open questions - What is still undecided for the Nuxt site.
  • Backend endpoints - The smallest API the frontend needs from the Go gateway: health, chapters, metrics, knockdown, events.
  • Profile data - The LinkedIn export behind the terminal chapters, what is real vs mock, and how to refresh it.
  • Future updates - Pipeline improvement backlog with effort estimates, not yet decided.
  • Update log - History of changes to this bundle.

Decisions

CI/CD and releases (2026-10-18)

Docker and development environment

  • Dev container shape - The source is bind-mounted into a container that already holds the dependencies, and the dev server runs as the image's node user.
  • Build layer order - Why the manifests are copied before the source, and what invalidates what.
  • Build context filter - What .dockerignore may exclude, and the one thing it must never exclude.
  • Production image shape - Multi-stage, digest-pinned, non-root runnable Node server - measured build and serve.
  • Repository and compose layout - The Dockerfiles live with the app; the stack is assembled in Local_Development.
  • Mockup layout - One DESIGN.md per screen, with the screenshot and the source embedded.

UI and icons (2026-10-23)

  • Icons via Nuxt Icon - Icons come only from @nuxt/icon with a locally installed Material Symbols collection; inline SVG for SSR, scanned client bundle, and no icon webfont.
  • SEO stack and site metadata - @nuxtjs/seo with one metadata file, a Person identity, a committed 1200x630 OG card, and no dynamic OG renderer or skew protection.

The one-paragraph history

The repository started as the Nuxt app shell. Docker development (dev container, layer order, context filter) came first, then a single day of CI/CD work built the PR pipeline layer by layer — lint, typecheck, secret scan, dependency audit, Dockerfile lint, AI review — fixing one real failure per layer as it appeared (wrong provider account, wrong CLI major version, arm64-hostile vendor images, a silently-skipping hashFiles, a prompt-injectable credential file), then wired releases via release-please and locked the message format with pre-commit hooks. The pipeline now fails loudly, posts only real reviews, and needs no human faith to operate.