DePunks — overview
A web3 NFT project with AI-driven design and a complete in-house build — smart contracts, web app, and tooling — on Ethereum mainnet.
What it is
DePunks is an NFT project where users can:
- Mint DePunk NFTs (ERC-721) with placeholder slots for attributes.
- Mint random attribute packs (ERC-1155) containing items like caps, eye patches, and pipes.
- Equip attributes to DePunks — burning the attribute token and updating the DePunk’s metadata.
The build is fully in-house: contracts, the app, and the supporting tooling are all part of the project rather than assembled from off-the-shelf services.
Tech stack (web app)
| Layer | Choice |
|---|---|
| Framework | RedwoodSDK with server-side rendering |
| Database | Drizzle ORM on Cloudflare D1 |
| Web3 | Viem + Wagmi for blockchain interactions |
| Auth | Sign-In with Ethereum (SIWE) + EIP-1271 for smart wallets |
| Styling | Tailwind CSS v4 |
| Network | Ethereum mainnet |
Design language
DePunks has a documented, copy-paste-ready design system:
- Dark-first. Dark mode is the default; light mode is a clean inversion, not an afterthought.
- Punk edge. Neon lime-green accent (
#b8ff00), deep charcoal surfaces, neumorphic shadows with subtle white highlights. - Pixel-art nostalgia. NFT images render pixelated — the retro aesthetic is intentional.
- Minimal palette. Semantic tokens (
--surface,--text,--accent,--border) do the heavy lifting; raw hex avoided except for static brand colors. - Monospace for data. Numbers, stats, and counts use JetBrains Mono.
Status
- Documented (~70%). Contracts, app, design system, and flow diagrams exist in-repo.
- Next: produce the case-study visuals — cover (motion loop), key screens, and the mint → equip flow diagram.