Chapters
Builder's guide
The stack, the good practices and the resources for a project that is starting today — from the first question (does this need Web3?) to the demo. Short pages, in order, written to be copied into your repo or handed to your coding agent.
Last reviewed 11 Sep 2026 · a living document
Start here
Five pages, in this order, and you have a project on devnet with a real RPC by tonight.
Getting started
- Does this need Web3?Six questions before you open the editor. If none is a yes, do not use a blockchain.
- The recommended stackWhat to use at each layer and why, in one table.
- InstallationRust, Solana CLI, Anchor, Surfpool and Node in fifteen minutes — and the versions that matter today.
- Your first projectThe official scaffold, the templates, and the thing most teams lose: the program keypair.
- DevnetDevnet, always. Pointing the CLI, Anchor and the frontend at the same network.
Build
- WalletsThe user installs nothing: embedded wallets, Wallet Standard and gas paid by the app.
- Client, tokens and dataKit, tokens, NFTs, oracles, payments, credentials: which library for what.
- TestingUnit, integration and devnet smoke — and why anchor test is not end-to-end.
- Coding with AIThe official Solana MCP and skill, and the rules that stop the model writing 2023 code.
Infrastructure
Security
Recipes and errors
For your coding agent
Drop the rules file in your repo root, or point the agent at the whole guide as one Markdown file. Both take a ?lang= parameter, because curl has no cookie.
curl -o SOLANA-RULES.md https://superteam.ar/stack/rules?lang=en
# or hand it the whole guide:
https://superteam.ar/stack/markdown?lang=en