Skip to content

docs(site): landing page for the GitHub Pages site - #10

Merged
sardi-dev merged 1 commit into
mainfrom
docs/pages-landing
Oct 20, 2026
Merged

sardi-dev merged 1 commit into
mainfrom
docs/pages-landing

Conversation

@sardi-dev

@sardi-dev sardi-dev commented Oct 19, 2026 •

Copy link
Copy Markdown
Owner

What and why

Pages will serve docs/, which had no index.html. Only /demo/ had a page, so the repository's website address would show a 404 at the site root.

docs/index.html is a landing page:

  • the pitch, with "Walk the live demo" and "Get it on GitHub" buttons and the install line
  • the demo animation
  • the six "Why Wirehouse" points with the brand kit's spot illustrations
  • the "One map, two readers" image
  • how it works in three steps
  • a four-screenshot gallery

Details:

  • It follows light or dark mode. Light mode uses a darker accent for text, because yellow on paper fails contrast.
  • No horizontal scroll at phone width.
  • prefers-reduced-motion is respected.
  • Open Graph and Twitter previews use brand/social/og-image-1200x630.png; the favicons come from brand/favicon/.
  • Like the demo, it loads nothing from other hosts: the brand fonts are copied to docs/assets/fonts.css.

How I checked it

  • python -m pytest: no code changes
  • Rendered in Chromium, dark and light, at 1280 px and 390 px: no failed requests and no horizontal overflow
  • CHANGELOG.md updated under Unreleased

Ground rules

  • Nothing new is drawn or counted without a recorded connection or checked evidence
  • No secret values can reach archmap.json or the HTML
  • The page loads nothing from the network beyond its own files

Pages serves docs/, which had no index.html, so the site root and the
repository's website link showed a 404; only /demo/ had a page. The
landing page gives the pitch, the demo animation, the reasons to use
Wirehouse, the export image and a gallery, with Open Graph previews.
Fonts ship beside it so the page, like the demo, loads nothing from
other hosts.

sardi-dev commented Oct 19, 2026 •

Copy link
Copy Markdown
Owner Author

CI status: every job in the CI workflow fails before any step runs. That covers all 9 pytest jobs and viewer in a browser. Each job ends 2 to 7 seconds after starting, with no steps and no downloadable log.

This is not caused by this PR:

  • The PR only adds docs/index.html, docs/assets/fonts.css and a CHANGELOG entry. None of these are read by the workflow or the tests.
  • The same workflow passed on main yesterday (run 19, merge of the launch README).

I re-ran the failed jobs once (attempt 2), and they failed the same way.

I have no fix to port, because the cause is at the account or repository level, not in the code. The usual causes for jobs that die before setup:

  • Settings → Actions → General → Actions permissions excludes GitHub-authored actions such as actions/checkout.
  • A hold or spending limit under Billing.
  • A GitHub Actions incident.

The run page shows the exact reason as an annotation at the top.

@sardi-dev
sardi-dev merged commit 8881839 into main Oct 20, 2026
0 of 20 checks passed
@sardi-dev
sardi-dev deleted the docs/pages-landing branch October 20, 2026 19:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant