Overview card: honest start paths, funding, clickable links, brand shell#1
Merged
Conversation
- Split the 'Prefer written docs?' strip into two honest doors: written docs -> docs.ethswarm.org developer intro (QR), and 'Just shipping a website?' -> justdeploy, described as what it is (Browser/Beeport, Desktop app, CLI incl. Bee install & stamp top-up) - Restore v1's 'Feed slots hold <= 4 KB' gotcha - Restore v1's fuller back-page link lists (install guide, files, routing for SPAs, manifests/chunk-types, PSS+GSOC split, Bee source, docs home, foundation blog, SwarmScan, local test network) — every added path verified live (bogus paths confirmed to 404)
- Every QR gets wrapped in an anchor at render time; visible URLs and all back-card entries become deep links to their canonical targets - Links inherit the card's styling (hover affordance on screen only), so print output is pixel-identical; Chrome embeds them as PDF link annotations (45 unique) for the digitally-shared PDF - Link checker caught and fixed a stale v1 label: swarm-stream-js-lib does not exist -> Solar-Punk-Ltd/swarm-stream-js - All 48 card links verified alive
- Screen-only toolbar above the card: Download PDF (links to the generated file in dist/) and Print (window.print) as fallback - Fulfils the 'thin web page always offers the PDF download' role from the plan; hidden in @media print so output is unchanged
a[href]:hover outranked .btn:hover, painting the label the same deep-orange as the hover background (text vanished). Scope the global rule to a[href]:not(.btn):hover.
Funding is the biggest post-install bottleneck — the node won't run without funds. Surface fund.ethswarm.org (fund on Gnosis from any EVM chain, any token) in quickstart step 3 (right where the guided journey stalls) and in the back-page Get Started card after the install guides. Dropped the redundant 'type /swarm anytime' note to keep the front on one page.
Strip becomes read / fund / ship: docs, fund.ethswarm.org (with its own QR — 'a node without funds won't run', any EVM chain/any token), and justdeploy. Step 3 keeps a one-line 'fund the node — see below' pointer; justdeploy copy shortened to Browser · Desktop app · CLI so the three doors align.
…verb, parallel with 'Fund your node')
- 'Quickstart for Swarm development / recommended way / ~5 min' becomes 'Start building on Swarm — three ways in, pick your path': Beeport (browser, no install — hosted gateway upload, correctly described), run a Bee light node (official install one-liner + swarm-cli, Node>=18 noted), and Claude Code skills labeled 'Optional - AI-assisted' - Fix skill-loading bug inherited from v1: cd swarm-quickstart-skills (repo root), not .claude/ (skills would not load from inside it) - Add bee dev mode (local node, free stamps) with verified docs link - New gotcha: public gateway blocks unreviewed sites -> bzz.limo/bzz/<hash> (also added to back-page Gateways card) - Add /swarm-troubleshoot pointer; density trims keep front on one page - All 53 links verified alive
Screen-only chrome: #0D1216 background (site's own token), header with the white wordmark + Download/Print buttons, slim footer with curated links (ethswarm.org, docs, github, discord, blog). White logo variant vendored as assets/swarm-logo-white.svg. Print output unchanged.
Taken from ethersphere/ethswarm-nextjs (Footer.tsx, tailwind.config, footer.json) instead of eyeballed compiled CSS: footer gradient #1F2831->black as the page background, muted #8B909A, footer links as semibold #F6F7F9 with opacity-70 hover (their pattern, not orange), plus a 10px 50%-opacity micro-line mirroring their bottom bar (carries the verified-versions string). html pinned to black so the gradient ends seamlessly.
v1's marketing slogan clashed with 'Capacity & lifetime are non-deterministic' below it; 'No servers, no gatekeepers' is the defensible version.
Its message was already on the card twice (Not-free-to-write bullet, fund door), and the node-mode jargon mainly serves Desktop users the card doesn't target. 'Not free to write' now reads 'funded light node and a stamp paid in xBZZ' so the unique nugget survives.
Card ships alongside Bee 2.8.1: TAG=v2.8.1 in the install command and both verified-against lines updated. check-links.sh now extracts every pinned TAG=vX.Y.Z and verifies the GitHub release exists — it fails with 'do not print until it is' while 2.8.1 is unpublished, so CI stays red exactly until the release lands.
Redundant with the header wordmark right above; the hero text gets the width back.
A4 at native CSS size is ~794px wide; zoom:1.2 on body scales sheet and chrome together to ~953px. Print/PDF output unaffected.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Improvements to the Overview card on top of the Phase 1.5 baseline (v1-matched design, hardened PDF pipeline, link checker + CI).
Content & journey
cd swarm-quickstart-skills/.claude→cd swarm-quickstart-skills(skills don't load when cwd is the.claudedir itself).fund.ethswarm.orggets a QR door in the strip ("a node without funds won't run", any EVM chain/any token) plus entries at both moments of need.bzz.limo/bzz/<hash>/; restored v1's "feed slots ≤ 4 KB". Dropped the redundant ultra-light bullet (folded into "Not free to write").bee devmode (local node, free stamps) added to the node path;/swarm-troubleshootpointer added.Web version
swarm-stream-js-lib→swarm-stream-js).ethersphere/ethswarm-nextjs(footer gradient#1F2831→black, muted#8B909A, semibold#F6F7F9links with opacity hover) + slim footer and verified-versions micro-line. 120% screen zoom for readability. Print output pixel-identical.Guards
check-links.shnow also verifies the pinnedTAG=vX.Y.Zexists as a GitHub release — CI stays red until Bee v2.8.1 is published ("do not print until it is"), then flips green automatically.