Skip to content

Repository files navigation

Metanet.fyi

Metanet.fyi is the “concept → proof → action” field guide for the Metanet. Its first skyscraper guide explains BSV overlays to non-technical readers while maintaining a direct source trail into current specifications, working code, and operational choices.

What is here

  • /overlays — the flagship visual guide
  • /overlays/recovery — an interactive, browser-local data survival test
  • /overlays/build — a six-stage implementation and operational roadmap
  • /resources — a reviewed, status-labeled source atlas
  • /resources.json and /llms.txt — machine-readable discovery surfaces

The site is server-rendered by a small Node.js HTTP service. It has no production package dependencies, uses no remote fonts, and sends only privacy-bounded interaction signals when the browser does not advertise GPC or DNT.

Development and verification

Requires Node.js 22 or later.

npm install
npx playwright install chromium
npm run dev
npm run verify

The local site listens on http://localhost:4321. Verification includes unit/API tests, build generation, Chromium accessibility and responsive checks, and four mobile Lighthouse audits. Lighthouse thresholds are 95 performance and 100 accessibility, best practices, and SEO.

Social previews

Every public route declares its own versioned 1200×630 JPEG through Open Graph, Twitter Card, standard image discovery, and schema.org metadata. npm run build regenerates those cards plus the legacy PNG aliases and install icons. The generator converts the pinned project typefaces into SVG glyph outlines before rasterizing them, so production output does not depend on fonts installed on—or supported by—the build runner.

The test suite verifies dimensions, format, opacity, color space, byte size, cache and cross-origin headers, per-route uniqueness, and successful retrieval using Slack, X/Twitter, Facebook, LinkedIn, and Discord crawler user agents.

Deployment

GitHub Actions builds a traceable Linux/amd64 image on the Evans Creek self-hosted runner and pushes it to the cluster registry. Kubernetes, DNS, certificates, rollback, and operational evidence are owned by the private network-ops repository.

Licensing

Code is licensed under the MIT License in LICENSE-CODE. Original editorial content and diagrams are licensed CC BY 4.0 in LICENSE-CONTENT.

About

A proof-oriented field guide to the Metanet, beginning with BSV overlay networks.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages