Skip to content

Redesign the README: banner, walkthrough and architecture cards - #19

Merged
operatoruplift merged 1 commit into
mainfrom
claude/readme-redesign
Oct 31, 2026
Merged

operatoruplift merged 1 commit into
mainfrom
claude/readme-redesign

Conversation

@operatoruplift

@operatoruplift operatoruplift commented Oct 30, 2026 •

Copy link
Copy Markdown
Owner

What changed

The README was a dense verification document with no visuals. This rebuilds it in the same house style as the Operator Uplift website and the operatoruplift profile:

  • Header: banner, three call-to-action buttons (policy lab, product tour, developer guide), CI and stack badges, the tagline, the Approve → Propose → Check → Reserve → Sign → Receipt flow, and section links.
  • Screens card: four real screens of the public rehearsal with numbered captions, rendered for light and dark themes.
  • How it works: an Agent → Allowance → Solana flow card (light and dark), the three guarantees, and a table of the two payment rails.
  • Trust model and Status sections with the same scoping as before: no settlement claimed beyond the dated 20 September 2026 inspection.
  • Run it locally: the commands CI runs, operator setup, and a table of the live-payment flags. Docker, routes and repository layout move into collapsible sections, so no operational instruction was dropped.
  • Fix: the RVAClassic link pointed at x.com/operatoruplift; it now points at x.com/rvaclassic.

All images live in docs/readme/ (five PNGs, about 1 MB in total). Screenshots were captured from a local build of the public rehearsal (npm run build:rehearsal), so no funds moved.

Checks

  • npm run check passes (lint, types, 376 Vitest tests in 39 files, production build).
  • README check: no broken relative links or anchors, alt text on every image, no em dashes.

Suggested repository settings

These live outside the code, so they are not in this PR:

  • Topics: solana, x402, ai-agents, usdc, mcp, agentic-payments, payments
  • Social preview: upload docs/readme/banner.png (2400 × 1200) under Settings → General → Social preview.

https://claude.ai/code/session_01TZhsuWjATuivuiFYJGpbY5


Generated by Claude Code

… cards

- Open with a banner, call-to-action buttons, status badges, the tagline
  and section links, in the Operator Uplift house style
- Add a four-step screens card and an Agent, Allowance, Solana flow card,
  each rendered for GitHub's light and dark themes
- Reorganize the old text into How it works, Trust model, Status, Run it
  locally and Documentation; Docker, routes and layout move into
  collapsible sections, so no operational instruction is lost
- Keep every settlement statement scoped to the dated evidence
- Point the RVAClassic link at x.com/rvaclassic (it pointed at
  x.com/operatoruplift)

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01TZhsuWjATuivuiFYJGpbY5
@vercel

vercel Bot commented Oct 30, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
allowanceonsolana Ready Ready Preview Oct 30, 2026 7:54pm UTC

Request Review

@operatoruplift
operatoruplift merged commit d3850c7 into main Oct 31, 2026
5 checks passed

This branch was successfully deployed

1 active deployment
Preview — bd3b0324 Deployed Oct 30, 2026 by vercel[bot]
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.

2 participants