Click an empty white square below to mint an available Su Square (0.5 ETH). Clicking an already minted and personalized one will activate its hyperlink.
You can display the fully functional billboard on your site or app with our embed feature. Copy the iframe or URL to use it; or if you want to customize it (the background, text, colors), visit the embed builder page.
Enter an already minted Square to look up information about it.
Learn the technicals behind how this historic project works.
Su Squares is much more than a historic smart contract or a collectible billboard on Ethereum... it offers a complete, open-source ecosystem-as-a-playground you can study,
run, and modify yourself. The same GitHub repository that powers this live Jekyll dApp also contains the smart
contracts, local blockchain setup, UI library, and tests that make the project work end-to-end.
And it's all made accessible through an agent-guided experience that works with you using your preferred AI models in your IDE.
It's an Agent-Guided Repository (AGR) with different modes your agents can use to help you smoothly navigate and learn what you want at your own pace.
Inside the repo you can:
Spin up your own Su Squares dApp with your own smart contract deployments, customize the entire Billboard, run it on a private local Ethereum-like network you can manage and configure. You can experiment safely without touching mainnet or spending real ETH.
Run the ERC-721 smart contract that defined the entire digital collectibles ecosystem, using modern tooling, tests and accessible scripts to explore the full gamut of use cases.
Browse the production UI components in isolation: the billboard, square lookup tools, choosers, wallet and transaction modals, offline banner, nav, and more. It’s the live interface broken down into testable, reusable pieces.
Use Playwright to run end-to-end browser tests against the app, and Vitest to validate helper logic and behavior. You can watch how a production NFT project wires testing around contracts and UI.
Examine the Node.js workspaces that handle contracts, local network scripts, UI tooling, and test runners, alongside the Jekyll code that renders this very dApp. Everything is wired so you can clone, install dependencies, and follow the same commands we use.
