Skip to content

Gnosis EEZ prelaunch: content pass, agent-ready llms.txt and gnosis.io v4 design - #898

Merged
Wagalidoom merged 18 commits into
gnosischain:devfrom
KenCarvAPI:GnosisEEZ_prelaunch
Nov 2, 2026
Merged

Gnosis EEZ prelaunch: content pass, agent-ready llms.txt and gnosis.io v4 design#898
Wagalidoom merged 18 commits into
gnosischain:devfrom
KenCarvAPI:GnosisEEZ_prelaunch

Conversation

@Tommy-R8

@Tommy-R8 Tommy-R8 commented Oct 30, 2026

Copy link
Copy Markdown
Contributor

Why

#895 merged the Gnosis EEZ prelaunch branch, but the branch kept moving after that. This brings over what landed since: a content pass, a real llms.txt for agents, and Rom's visual pass that aligns the docs with gnosis.io v4 (KenCarvAPI#6).

What changes

Content

  • Prelaunch content pass across the EEZ, bridges and developer guide pages.
  • How it works gets the EezCallReturn diagram.

Design (Rom, KenCarvAPI#6)

  • Docs UI aligned with the gnosis.io v4 identity: Inter, colors, cards, admonitions, the Algolia search modal and a new social share card.
  • External links in page content get an ↗ icon and open in a new tab.
  • Tables size their columns to their content and scroll sideways on narrow screens instead of breaking words.
  • The Docs menu links to Home and Ecosystem on gnosis.io. Build (build.gnosischain.com) stays in the menu, and the footer and Gnosis Chain sidebar now call that link Build too, instead of Ecosystem.

Agent output (llms.txt)

  • llms.txt used to be a 660 KB dump of raw MDX committed to static/. It is now generated at build time by @signalwire/docusaurus-plugin-llms-txt, through a small wrapper in src/plugins/llms-txt.mjs. This produces:
    • llms.txt: an index in llmstxt.org format (about 37 KB), with the EEZ pages first.
    • llms-full.txt: every page, in the same order as the index.
    • One .md copy per page. The Copy page button uses these.
  • The wrapper cleans up the conversion: tab labels stay next to their content, code blocks stay intact, and links to folder index pages resolve.
  • static/llms.txt and the unused docusaurus-plugin-generate-llms-txt dependency are removed. This accounts for most of the deleted lines.
  • Works with docs(node): keep the Run a node guides available until the Gnosis EEZ fork #897: the Run a node pages show a "valid until the fork" notice from a DocItem wrapper, which sits outside the content the plugin converts. The wrapper adds the same notice to the .md copy and the llms-full.txt entry of every /node page, so agents get the warning too.

Checked

🤖 Generated with Claude Code

TimesThreeDX and others added 15 commits October 29, 2026 10:18
TimesThreeDX @claude
Docs: prelaunch content pass across EEZ, bridges and developer guides
8dcb744 
- How it works: add "The EEZ protocol underneath" with a themed call/return
  diagram (EezCallReturn); drop the draft review box, pipeline and launch notes
- References & Demos: rename the demos page, regroup into learn, protocol
  docs and source code, add Remix with EEZ and the engineer references
- Glossary moves into the Knowledge hub at /knowledge-hub/glossary, with a
  redirect from /eez/glossary
- Launch partner: define which deployed contracts count, cut the Derive example
- Deploy now: explain up front that Gnosis Chain becomes Gnosis EEZ
- Guides: Job, Time and Chain each on their own line
- CoW Swap guide: remove EEZ framing; it is a Gnosis Chain guide
- Bridge validators: link to the live Bridge Explorer instead of static tables

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@romully @claude
design(docs): align docs UI with gnosis.io v4 identity
8fb4dae 
Header / navbar:
- All-sans type: load Inter, retire Suisse Intl + Unica 77
- Logo matched to gnosis.io exactly (22px, natural aspect, x~48, top 34)
- Nav links 13px/500; remove marketing CTA to keep a clean docs header
- Site switcher: Home/Ecosystem/Bridge as external links (new tab + icon),
  Faucets in-site; Ecosystem points at gnosis.io/chain/ecosystem
- Added header breathing room

Content:
- Breadcrumb minimal (no filled pill)
- Tables standardized: full-width, fixed columns, tinted header, zebra
- Cards unified; monochrome purple icon chips; Icon component + knowledge-hub icons
- Admonitions: icon in its own column, copy aligned to copy
- Pagination: edge arrows independent of text, clean ← / →
- Monochromatic home wash (light + dark), content on 48px grid

Sidebar:
- Wider (320px), labels wrap (no truncation)
- One consistent chevron; collapsed points right
- Collapse-sidebar button removed (hideable: false)

Search:
- Algolia DocSearch modal themed to brand tokens

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@romully @claude
design(docs): style Algolia search modal as a rounded card
e157132 
Rounded modal with border, the search field as a rounded card with inner
spacing and a purple focus ring, padded results, and a rounded footer with
key chips, matching the docs' other cards.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@romully @claude
design(docs): new v4 social share card
53fbfc1 
Replace the stale pre-v4 screenshot OG image with an on-brand 1200x630 card:
fresh light gradient, Gnosis Chain lockup, Playfair 'Documentation' headline,
Inter subtitle and the dot-field motif, matching gnosis.io / gnosispay.com v4.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@Tommy-R8 @claude
Docs: llms.txt becomes a real agent index, built at build time
1d14178 
- llms.txt is now an llmstxt.org index (title, summary, one section per
  part of the docs, Gnosis EEZ first), plus llms-full.txt and a .md copy
  of every page, from src/plugins/llms-txt.mjs (same as hub-wip).
- Drops docusaurus-plugin-generate-llms-txt, which dumped raw MDX into
  static/llms.txt on every build; the file is untracked (already in .gitignore).
- Folder index links in the .md output point at folder.md, not folder/.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Tommy-R8 @claude
Docs: llms.txt order picks up the glossary and node pages
aa080e0 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@romully @claude
design(docs): standardize index cards + mark external links
3a6ad62 
Generated-index / DocCardList cards now match the hand-authored <Card>
style (one surface, border, radius, hover) and use the shared line-icon
set (folder / file) in an accent-soft chip instead of the default
emoji. Titles and descriptions wrap instead of truncating.

In-text external links now open in a new tab (target=_blank,
rel=noopener noreferrer) and carry a trailing arrow glyph so readers
know the link leaves the docs. Internal and relative links unchanged.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@romully @claude
design(docs): standardize secondary CTA as outlined pill
896455f 
The secondary button rendered as a bare purple text link, so it did
not read as a button next to the primary ink pill (bridges, EEZ
launch-partner CTA rows). Make button--secondary an outlined ink pill:
transparent with an ink border and label, filling to ink on hover.
Same pill shape and height as the primary, consistent app-wide.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@romully @claude
design(docs): auto table layout so columns size to content
76a4c8b 
Fixed table layout split the leftover width evenly, stretching short
action/link columns and leaving dead space. Switch to auto layout so
columns hug their content and the prose column takes the slack. Keep
external-link arrows on one line inside table cells so the glyph never
orphans.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@romully @claude
design(docs): brand/accessible admonitions + strip decorative emoji
01615b9 
Admonitions used Infima's stock cyan/amber/green, which fail contrast
and sit off-brand. Theme all five types to a legible accent (info →
brand purple, tip → Chain emerald, warning/danger → darkened functional
hues) with a soft same-hue tint, in light and dark. Bump --gc-text-faint
to clear the AA floor for captions.

Remove redundant decorative emoji from boxes, headings and table headers
(🚨 ✅ ⚔ 🦸 💡 🔍) now that admonitions carry their own semantic icon,
and fix two em dashes in the Hashi deprecation notice. Literal CLI/test
output and governance status markers are left untouched.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@romully @claude
design(docs): wide tables scroll instead of crushing columns
07cba34 
Wrap every markdown table in a horizontally-scrollable container and
stop force-breaking cell content. Wide tables (the bridge-limits table
has 8 columns of 27-digit wei values) kept their columns at natural
width and scroll sideways, instead of shredding numbers and headers
into vertical character stacks. Narrow tables still fill the column.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@Tommy-R8 @claude
Merge PR #6: Docs UI aligned with gnosis.io v4 (romully/design/eez-pr…
1393bfd 
…elaunch)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Tommy-R8 @claude
Docs: Build link in the Docs menu, footer and Gnosis Chain sidebar
f4248e7 
The Docs menu keeps Rom's Ecosystem link to gnosis.io and gets Build back.
The footer and sidebar link to the same site, so they now say Build too.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Tommy-R8 @claude
Docs: agent copies of Run a node pages carry the until-the-fork notice
8089055 
gnosischain#897 shows the notice from a DocItem wrapper, outside the content the
llms-txt plugin converts, so the .md copies of /node pages lost it.
The plugin now adds the same notice to them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Tommy-R8 @claude
Docs: llms-full.txt carries the Run a node notice too
b15c7c2 
The plugin builds llms-full.txt from the .md files before our postBuild
adds the notice. Rebuild it from the final pages instead: the index,
then every listed page in index order. Fails the build if a listed page
has no .md file.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Tommy-R8
Tommy-R8 requested review from a team and 0xarmagan as code owners October 30, 2026 14:12
@vanshika-srivastava

vanshika-srivastava commented Oct 30, 2026 via email

Copy link
Copy Markdown
Contributor

Tommy-R8 and others added 3 commits October 30, 2026 12:41
@Tommy-R8 @claude
Docs: Ecosystem in the Docs menu links to the build site
ec1333d 
Build and Ecosystem both live on build.gnosischain.com, so the menu
no longer splits them between gnosis.io and gnosischain.com.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Tommy-R8 @claude
Docs: Build and Ecosystem links go to gnosis.io
3f755b0 
The Docs menu, footer and Gnosis Chain sidebar link to
gnosis.io/chain/build and gnosis.io/chain/ecosystem, the main site.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Tommy-R8 @claude
Docs: ecosystem directory links go to gnosis.io
693b2a3 
Page links to build.gnosischain.com now point at gnosis.io/chain/ecosystem,
matching the menu, footer and sidebar.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Wagalidoom
Wagalidoom merged commit 5b62676 into gnosischain:dev Nov 2, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@0xarmagan 0xarmagan Awaiting requested review from 0xarmagan 0xarmagan is a code owner

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@Tommy-R8 @vanshika-srivastava @Wagalidoom @romully