Files
portfolio/docs/codebase-index.md
T
2026-11-09 15:19:44 +01:00

2.8 KiB

Codebase index

Indexed 9 November 2026, before the content workflow changes. This is a vanilla JavaScript static portfolio with hash routing, Dutch/English text, and no runtime dependencies.

File Responsibility
content/projects/*.json Editable projects, each with its evidence items; display order uses number
content/settings.json Profile links, pinned source revision, eight process definitions
content.js Generated browser module; do not edit directly
app.js DOM rendering, translations, navigation, evidence filtering and printing
styles.css Desktop/mobile layouts, project diagrams, accessibility and print styles
index.html, favicon.svg Document shell, metadata and icon
scripts/content.mjs Validate content, generate module, scaffold a project
scripts/serve.mjs Loopback-only static preview; compiles content when requested
scripts/build.mjs Validate/generate content, copy five public assets to dist/
tests/ Content integrity and editing regression checks
Dockerfile, .dockerignore Build and test source in Node, then serve public assets with Nginx; see compose.yaml, docker/nginx.conf and docs/docker-hosting.md
docs/verification.md Earlier verification record, not a current test report

Rendering and dependencies

content/ → scripts/content.mjs → content.js → app.js → main

Routes: #home, #work, #project/<id>, #evidence, #evidence/<code>, #about. Unknown routes show a 404. Language is selected using ?lang=nl or ?lang=en.

header and footer render shared navigation. home and work render project lists; detail renders a dossier. processRow derives evidence counts and links from every project's evidence array. Removing evidence automatically removes its process-index entries.

At initial indexing there were three projects and twelve evidence entries in a single handwritten content.js. The homepage assumed at least one project, linked directly to warehouse, and displayed a fixed count. These assumptions were removed for content management. The first project by number is now featured; an empty portfolio is supported.

Project IDs are stable route identifiers. Evidence paths are relative to profile.school at the pinned revision. Text pairs are [Dutch, English]. The existing design uses exactly three diagram nodes. Personal contribution and reflection copy is still shared placeholder text in app.js.

Exposure boundary

Editing happens in local JSON files. The preview server has no write endpoint and binds to 127.0.0.1. Production ships five static files, with no editor, login, database, or server process. All content included in a build is public: only put publishable material in these files. Publish dist/, not the repository root.