Skip to content

Add Specifications tab with Cobalt, Beryl, and Azul upgrade pages - #1836

Open
mindapivessa wants to merge 14 commits into
masterfrom
docs/specs-tab
Open

Add Specifications tab with Cobalt, Beryl, and Azul upgrade pages#1836
mindapivessa wants to merge 14 commits into
masterfrom
docs/specs-tab

Conversation

@mindapivessa

Copy link
Copy Markdown
Collaborator

Summary

  • Adds a new Specifications tab to the top nav with Cobalt, Beryl, and Azul sections
  • Creates overview pages for each hardfork with status tables and feature cards
  • Adds the full B20 specification under Beryl
  • Adds placeholder pages for Reth V2, Faster Withdrawals, and B20 Improvements (Cobalt)

Test plan

  • Verify Specifications tab appears in the nav
  • Verify Cobalt, Beryl, Azul overview pages load and display feature cards
  • Verify B20 spec page loads under Beryl
  • Verify placeholder pages show "Coming soon."
  • Verify no existing pages are broken

🤖 Generated with Claude Code

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, 9:15 PM

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.

3 participants