Skip to content

docs: B20 docs example - #1835

Open
mindapivessa wants to merge 22 commits into
masterfrom
docs/ia-overhaul-v2
Open

docs: B20 docs example#1835
mindapivessa wants to merge 22 commits into
masterfrom
docs/ia-overhaul-v2

Conversation

@mindapivessa

Copy link
Copy Markdown
Collaborator

What changed? Why?

Notes to reviewers

How has it been tested?

mindapivessa and others added 14 commits July 29, 2026 14:19
Turn the Issue Stablecoins stub into a Stripe-style, demo-driven section
built around the B20 stablecoin variant.

- Get Started landing (get-started/issue-stablecoins) with an interactive
  demo above a CardGroup of the issuer jobs
- Eight short, single-purpose Build on Base pages: issue, mint, burn,
  restrict, block, recover, pause, reconcile
- New self-contained StablecoinDemo.jsx snippet (flow selector, timeline,
  progress bar, animated log, balances) replacing the Visibility-wrapped
  reuse that failed to render
- Nav: Issue Stablecoins ordered above Integrate DeFi in both tabs;
  redirect for the removed stub; page title capitalized

Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
…tegy sections

Execute the use-case IA overhaul (Phases 1–4) on top of the skeleton.

Facilitate Payments (Phase 1)
- New Solutions landing get-started/agentic-payments + 5 byte guides under
  build-on-base/agentic-payments (accept, verify, payer info, subscriptions, x402)
- New scripted snippets/PaymentsDemo.jsx (5 flows), modeled on StablecoinDemo
- Rewrite get-started/base (use-case-first) and ecosystem-bridges (route chooser)

SDKs & APIs (Phase 2)
- Relocate base-account -> sdks/base-account (whole tree; preserves link equity)
- Curated tab: Overview / Base Account SDK / Base Chain API
- New sdks/overview (hub) + sdks/base-account/overview (SDK landing)

The cut (Phase 3)
- Delete /agents (Base MCP), /apps (MiniKit), /onchainkit
- 301-redirect every removed/moved URL (615 -> 791); repoint 362 destinations
  out of cut trees; fix 133 pre-existing danglers; repoint surviving cross-links
- Delete stale per-section llms shards; regenerate AGENTS.md + llms.txt/llms-full.txt

Scaffolding (Phase 4)
- Fill Start Here trio, use-base-with-ai (x402), build-on-base/overview,
  get-started/{base-chain,sdks-and-apis} landings

Tooling: fix two real lint-mdx.js bugs (closing fences and HTML comments inside
fenced code blocks were false-flagged). No lint errors in new/migrated content.

Co-Authored-By: Claude <noreply@anthropic.com>
…t DeFi/Perps

Nav & IA refinements on top of the use-case overhaul:

- Get Started "Agents" group renamed to "Coding agents" = resources-for-ai-agents,
  docs-mcp, docs-llms. Removed "Build on Base with AI" (use-base-with-ai); repointed
  its 69 inbound redirects to resources-for-ai-agents.
- Reshaped Ledgers to the byte-guide pattern: removed ledgers-overview and folded its
  value-prop into the get-started/private-transactions landing; added small single-intent
  guides build-on-base/ledgers/{deposit,transfer,withdraw} with scoped demos; new
  snippets/LedgersDemo.jsx (deposit/transact/withdraw flows with a privacy readout).
- Removed the Perps section and the Integrate DeFi section (Get Started + Build on Base).
  Perps redirects to overview; DeFi removed without redirects (empty stubs).
- Title Case across all sidebar page titles and group names, preserving code identifiers
  (method names) and acronyms/brands.
- Added a site-wide draft banner and marked the "SDKs & APIs [WIP]" tab.
- Regenerated AGENTS.md, llms.txt, llms-full.txt.

Co-Authored-By: Claude <noreply@anthropic.com>
Remove the orange `type`/`color` override; keep the default banner style.

Co-Authored-By: Claude <noreply@anthropic.com>
- Update subtitle to "The blockchain for global finance."
- Remove the Explore section; add a Solutions card per use case
  (stablecoins, lending, tokenized stocks, payments, private txns)
- Rename "Facilitate Payments" -> "Accept Payments" (landing, nav
  group, and page title)
- Resources: drop Retroactive Funding and Join the Base Ecosystem,
  add Base dashboard link
- Set card titles to 1.25rem

Co-Authored-By: Claude <noreply@anthropic.com>
Co-authored-by: Codex <codex-noreply@coinbase.com>
Co-authored-by: Codex <codex-noreply@coinbase.com>
Redesign all 16 demo snippets around the generated Base design system,
rebuilding component anatomy (not just styling):

- Workflow demos (stablecoin, asset, DeFi, ledgers, payments, B20): horizontal
  stage navigation, split progress-rail / domain inspector workspace with a
  centralized action, and a separate transaction event log.
- Assistant demos: intentional landing composition with suggested prompts,
  detailed MCP tool-call cards (args + result tables), and a bottom composer.
- Transaction/signing approvals and the auth screen use the light Base
  modal/product system.
- Remove the decorative nav and header logo; put the stage row on the same
  line as the Demo tag and reset; drop the unused event-log auto-scroll toggle.

Add the official Base brand SVGs used by the demos.

Co-Authored-By: Claude <noreply@anthropic.com>
…emo, payer-info pay step

Co-Authored-By: Claude <noreply@anthropic.com>
Bring every interactive demo snippet in line with the Base design system
guidelines: dynamic dark mode, the BDS text-style variants, and correct
casing. Styling only — no logic, scripted-flow data, or interaction
behavior changed.

- Dark mode: convert each demo's hardcoded palette to CSS custom
  properties. Dark tokens resolve from both the system setting
  (prefers-color-scheme) and the docs' explicit theme toggle
  (html.dark / [data-theme="dark"]), with light overrides so the toggle
  wins in either direction. Demos now follow the docs theme dynamically
  instead of rendering light-only.
- Text styles: add in-snippet BDS text-variant classes
  (title2/title3/headline/body/caption/button/footnote/mono) with the
  correct sizes, weights, tracking, and md (768px) breakpoint; route
  visible text through them and drop conflicting inline font props.
- Casing: sentence-case UI chrome (e.g. "MCP tool call"; Blocked/Paused/
  Hidden/Public badges), leaving code identifiers, token symbols, and
  brands (B20, MCP, x402, Base Vibenet) untouched.

All 16 files parse as valid JSX; verified in light and dark across the
workflow, assistant, and auth demo families.

Co-Authored-By: Claude <noreply@anthropic.com>
…net guide

- Move launch-b20-token -> base-chain/network-information/b20-token-standard
  (Chain > Core Concepts), retitle "B20 Token Standard", reframe concepts-first;
  add redirect from the old path
- Replace the "Complete Launch a B20 token first" prerequisite note in 15
  issue-stablecoins/tokenize-stocks guides with a pointer to the standard page
- Re-point all internal links to the new path
- Add a "See technical details" CTA to the four use-case demos (Stablecoin,
  Asset, DeFi, Payments)
- Rewrite the Test on Vibenet page: intro, chain.base.org/vibenet iframe,
  network details, and faucet
- Regenerate llms.txt, llms-full.txt, and AGENTS.md

Co-Authored-By: Claude <noreply@anthropic.com>
- Drop the "Ethereum Layer 2" framing and remove em-dashes from the intro
- Rename the "Issue Stablecoins" quick-links group to "Issue Assets" and add
  stock-issuance links (tokenize stocks, create a stock token)

Co-Authored-By: Claude <noreply@anthropic.com>
@cb-heimdall

Copy link
Copy Markdown
Collaborator

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1
@mintlify

mintlify Bot commented Aug 19, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
base 🟢 Ready View Preview Aug 19, 2026, 8:44 PM
mindapivessa and others added 2 commits August 19, 2026 17:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

3 participants