ufuknode/base-builder-guide

Base Builder Guide is a reference document meant to be handed to an AI assistant before you start building something on Base, the blockchain network. Rather than being a plain list of links, it acts as an operating guide that tells an AI coding assistant exactly where to look in the Base ecosystem, which official sources to trust first, which tools and contract patterns to use, and how to turn a rough idea into a working Base project. The problem it addresses is that AI agents can drift toward outdated documentation, incomplete code examples, wrong network details, or generic blockchain advice when asked to build on a fast moving platform like Base. This guide gives the AI a clear route to follow: which docs to check, which GitHub repositories to reference, when to use specific Base features like Base App, Base Account, Base Pay, or Basenames, and how to plan out an MVP including frontend, backend, smart contracts, tests, and deployment. Using it is simple. You give the guide, specifically the file named base-builder-ai-guide.md, to an AI assistant along with a prompt asking it to either suggest project ideas for Base or turn an idea you already have into a working project plan, including wallet integration, payment verification, and a testnet deployment plan. The guide covers a wide range of Base-specific topics in one place, including the differences between Base Mainnet, Base Sepolia testnet, and Vibenet, smart contract deployment with a tool called Foundry, sign-in and payment flows, sponsored gas, Builder Code attribution, mobile-friendly app guidance, and security and testing checklists ahead of a mainnet launch. A few security principles run through the guide: never commit private keys or secrets to the repository, default new projects to the Base Sepolia test network rather than the real network, verify payments on the backend rather than trusting the frontend alone, and check wallet capabilities before relying on smart wallet features. The repository itself contains just two files: this README and the main guide document, plus a set of links to official Base documentation, status pages, and developer resources for anyone who wants to verify details directly.