PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / ESLint (pull_request) Successful in 35s
PR Check / Typecheck (pull_request) Successful in 38s
PR Check / Secret scan (gitleaks) (pull_request) Successful in 5s
PR Check / Dependency audit (pull_request) Failing after 8s
PR Check / Dockerfile lint (droast) (pull_request) Failing after 5s
PR Check / AI code review (opencode) (pull_request) Canceled after 16s
2.3 KiB
2.3 KiB
type, title, description, tags, status, generated, verified, sources
| type | title | description | tags | status | generated | verified | sources | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Decision | Mockup layout | Every mockup screen folder holds DESIGN.md, code.html and screen.png, with the screenshot and the full source embedded in the markdown. |
|
stable |
|
|
|
Decision
Each screen is one folder holding three files, all at the same level:
| File | Role |
|---|---|
DESIGN.md |
The screen as a document: frontmatter, the screenshot rendered inline, then the full source in a fenced block. |
code.html |
The screen's source, unchanged. |
screen.png |
The rendered screenshot, kept separately so it can be opened directly. |
The export's folder names were replaced with short, consistent ones:
| Export name | Folder |
|---|---|
noel_sabia_homepage_cv_overview |
homepage |
noel_sabia_overview_mobile |
homepage_mobile |
noel_sabia_dev_view_technical_telemetry |
dev_view |
noel_sabia_dev_view_mobile |
dev_view_mobile |
noel_sabia_life_map |
life_map |
noel_sabia_life_map_mobile |
life_map_mobile |
noel_sabia_infrastructure_ai_resilience |
design_system |
Why
A screen should be readable as one document without opening anything else, which
is what embedding the screenshot and the source gives. Keeping screen.png beside
the markdown as well is for looking at the picture on its own, without reading the
document around it.
The frontmatter on DESIGN.md — type, title, description, tags,
status — is also valid concept frontmatter, so these files are readable as
concepts if the mockups are ever folded into a knowledge bundle.
Notes
- The export shipped
DESIGN.mdand nothing else for the infrastructure folder. That folder is the design-token document, not a screen, so it deliberately has nocode.htmland noscreen.png. - A second, byte-identical copy of the export was deleted. Equality was checked
file by file with
cmpacross all 13 files before anything was removed. - Committed as
docs(design): embed screenshot and source into per-screen DESIGN.md.