Colophon
The Colophon: The Meta-Portfolio
“The medium is the message.” — Marshall McLuhan “The way you do anything is the way you do everything.” — The Code
This portfolio is not just a showcase; it is a portal into the engineering mindset. It is a custom-engineered Forensic Filing System built to handle 25+ years of high-density mechanical engineering data.
1. The Philosophy: The Pursuit of Truth
We treat this website as an evolving project, worthy of the same rigor as the hardware it documents.
- The Portal: The Colophon is the “Making Of” engine—a place to document the technological pursuit of truth and the tools that drive the hunt.
- Forensic Rigor: We do not fake data. We do not use “Lorem Ipsum.” Every metric, every part number, and every “War Story” is ground-truthed against reality.
- Curated Canon: This section serves as the living history of the site’s evolution, capturing the “self-imposed constraints” and the journey of building a digital home for physical work.
2. The Tech Stack (The Tools)
The system is built for stability, clarity, and forensic density.
| Layer | Technology | Rationale |
|---|---|---|
| Core | Astro 5.0 | Zero-JS default. Static HTML output. |
| Content | MDX + Zod | Astro content collections. No database to crash. |
| Styling | Tailwind v4 | Utility-first tokens. |
| Memory | The Testimonials | A collaboration log of the AI agents (The Council) who helped build it. |
| Assets | Cloudflare R2 | Global edge distribution for heavy binaries (.glb, .pdf). |
| Defense | The Jig | Automated Zod Schema validation (scripts/validate_manifest.ts). |
| Vision | Puppeteer | Visual Smoke Tests (scripts/visual_smoke_test.ts) to catch regressions. |
3. The Laws of the System
See The Engine Room for full architectural docs.
A. The Law of Hybrid Assets (“Human Eye, Machine Hand”)
We do not rely on automated plugins to crop or color-correct.
- Art Direction: Performed by humans in Lightroom.
- Optimization: Performed by Python scripts (
process_images.py). The two never overlap.
B. The Law of Narrative Impact
We assume the reader is busy. We use the BLUF (Bottom Line Up Front) principle.
- Metrics First: “Saved $15k” > “Worked on cost reduction.”
- Verbs over Adjectives: “Engineered” > “Responsible for.”
4. The History (Genealogy)
- Era 1 (The False Start): A generic “Neon Green” marketing site. Rejected for feeling “fake.”
- Era 2 (The Nuclear Scrub): The “ErikNorris” brand was stripped. YInMn Blue (the newest pigment discovered by science) was adopted for its stability and purity.
- Era 3 (The Institution): The move to “Forensic Architecture.” Integration of the Gemini Registry to handle 700+ data sources without breaking the UX.
- Era 4 (Diamond Hard): The shift to “Industrialization.” Deployment of automated “Hunter-Killer” scripts (
validate_manifest,verify_asset_links) to enforce data integrity and prevent “Ghost Assets” at scale. Confirmed by Red Team Audit.
5. Credits & Typography
- Typeface:
Inter(Rasmus Andersson) - Chosen for legibility at small sizes (UI). - Typeface:
JetBrains Mono- Chosen for code blocks and terminal outputs. - Icons:
Tabler Icons(Pixel-perfect SVG).
Built by Erik Norris. Maintained by the Forensic Portfolio Architect (Gemini Ultra).