Skip to content

docs: recommend UP Modal for Universal Profile connections - #1389

Merged
frozeman merged 2 commits into
mainfrom
docs/up-modal-recommended-connections
Oct 30, 2026
Merged

frozeman merged 2 commits into
mainfrom
docs/up-modal-recommended-connections

Conversation

@emmet-bot

Copy link
Copy Markdown
Contributor

Make UP Modal the recommended starting point for connecting Universal Profiles, and make its existing public quickstart easier to find from the homepage, Tools, connection Q&A, onboarding FAQ, provider tutorial, and generated AI index.

  • Clarify the quickstart title, description, minimal browser setup, runtime peers, and public API/npm/React/Vue resources, using the published 0.22.0 runtime and declarations as evidence.
  • Add one homepage CTA above the existing Q&A, one Tools card, and a human-readable sidebar label. Preserve advanced providers, EOA wallets, Grid-specific UP Provider, and SIWE guidance.
  • Update the existing inline llms.txt generator to use resolved document metadata and canonical absolute URLs with the site's trailing-slash setting. Put the recommended UP Modal links ahead of the full reference list. Local generation validates 250 canonical link entries (248 unique routes); generated files are not committed.
  • Keep the existing design and dependencies. The CTA uses the existing purple background and a scoped keyboard-focus ring.

Validation already completed on the reviewed candidate:

  • Direct Docusaurus production build and unchanged rebuild passed with broken links fatal; repository Prettier globs and checks of all ten changed files passed.
  • Six browser cases (1440, 390, and 320 pixels; light/dark) passed CTA placement, one-click home/Tools/FAQ navigation, Tab focus, Enter activation, and quickstart bounds. White 16px/700 text on #6C5DD3 measures 5.07:1; the 2px focus ring is retained. The existing 329px whole-home width at a 320px viewport is unchanged.
  • Independent review approved the exact ten-file candidate after the sole contrast correction, with zero remaining required source corrections. Approved diff SHA256: ebb1eceb131fa4254a010e4f99cbabfce1a5192598fa7265d60be9a1942f3c44.

Validation limits and required CI:

  • Local builds reused installed dependencies, some differing from the lockfile; Docusaurus itself matches locked 3.9.2. Missing Yarn 3 state/cache prevented a native locked local run, and a network-disabled immutable-cache attempt failed without downloading dependencies. These local results do not establish an exact-lock pass. This PR must run the repository's native frozen-lockfile install, formatter, production build, and other normal checks.
  • Published 0.22.0 API/runtime/type inspection was performed; no wallet integration was executed. No 1.0-only SDK behavior or unpublished release is claimed. A mismatching cached SDK was excluded from the API evidence.
  • Existing anchor warnings originate on 57 other pages, not the changed document routes. The npm website returned 403 to scripted access while public registry/source checks returned 200; the canonical npm URL remains valid evidence-wise.
  • An optional fresh review browser launch was denied before navigation. The successful implementation/fix browser receipts and images were independently inspected; no fresh review browser pass is claimed.

This is the requested focused docs PR. Production deployment, merge, automerge, deployed search ranking, and a new npm release are outside this request.

@emmet-bot
emmet-bot requested a review from CJ42 October 30, 2026 17:42
@github-actions

github-actions Bot commented Oct 30, 2026 •

Copy link
Copy Markdown
Contributor

Deployed with Cloudflare Pages ☁️ 🚀 🆗

@frozeman
frozeman merged commit 1ed056d into main Oct 30, 2026
3 checks passed
@frozeman
frozeman deleted the docs/up-modal-recommended-connections branch October 30, 2026 18:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants