Skip to content
bitcoinsv.design

Search the guide

Search the guide

The BSV design guide

Design BSV apps people trust

Design decisions for wallets, payments and connected apps. Read the guide, work through a checklist, or give your agent the skills to build from it.

For designers, researchers, founders, and the agents working with them.

satoshivision.example.com
SThe Satoshi Vision

The everyday issue

Small ideas. A wider world.

A few minutes of reading. A fresh way to see things.

25 sats per articleYour keys stay in your wallet.
Keys never leave the wallet

See how the connection works

Working examples, not just words

The details that make it work.

Try the decisions behind a good BSV interface. Each example links to the page that explains it.

Apps ask. Wallets decide.

Make every permission specific, understandable and easy to take back.

App permissions

The Satoshi Vision

satoshivision.example.com

Connected

Know who you are

Required to connect

Small payments

Up to 100 sats a day

Small payments need approval each time.

Design the connection

A payment with a clear ending.

Say who gets paid, what it costs and when the recipient has accepted it.

Review payment
M

Maya Chen

maya@example.com

25sats

One article · The Satoshi Vision

This can't be undone.

Follow a payment

Prove enough. Share less.

A Pass can answer a question without handing over someone's whole identity.

Share a Pass

Example Bar asks

Are you over 18?

Name, date of birth and address stay private.

Design for privacy

Two parts. One way back.

Recovery words restore your keys. A wallet backup restores your records: which money is yours and how to spend it. Design for both.

Your recovery kit

Recovery words

Your key recovery material

Wallet backup

Your wallet's records, encrypted

Save both parts to try the recovery check.

Build a recovery flow

Fictional interfaces. These controls only change the examples.

A reference with room to go deeper

123
guide pages
1022
rules you can check
52
glossary terms
7
reference designs

Every page written for BSV. Free to read. Published under the Open BSV License Version 6.

For teams building with agents

If an agent is doing the drawing

Some teams ship a BSV product with nobody whose job is the interface. The guide is published for them too: the same decisions, in forms an agent can follow.

bsv-design-review / SKILL.md

Your agent

Review the receive flow before shipping.

From the guide

  • Handle shown before the QR code
  • Amount in sats, digits grouped
  • Address labelled as a BSV address
See the skills
  • Skills, with the rules attached

    Procedures your agent can load, with a router that picks the right one: payments, wallet connection, micropayments, agent spending, tokens, backup and a design review. Each ships the guide's own rules, those that can cost a user money first, every one linked to the sentence it came from.

    See the skills
  • An MCP server over the whole guide

    Read-only. Search every page, read one in full, list the sections, or pull the rules that apply to what is being built in one round trip, mid-task, without guessing at a URL.

    Use the MCP server
  • All of it as markdown

    A map of every page at /llms.txt and the whole text at /llms-full.txt, so a model quotes the guide with a source instead of paraphrasing it from memory.

    Read /llms.txt

Built to be used, not just read

A reference you work from needs more than pages.

  • Search that finds the sentence

    Press / or Ctrl K (⌘K on a Mac). Titles and headings answer as you type, the full text follows a moment later, and every search has an address you can send someone.

  • Rules you can tick off

    Every do and don't becomes a checklist. Choose what you are building to get one list from every page that applies, then export a report that links each rule.

  • It remembers where you were

    Reading progress and saved pages, kept in your browser. No account, nothing sent anywhere.

  • Every rule has an address

    All 1022 rules have their own address. Link one in a pull request and anyone can open the sentence it came from.

Start with the screen you are drawing

The guide has the decisions behind it. The checklist has the rules, ready to tick.