Tutorial: Building a Governance Token (SIP-010 + On-Chain Voting)

[ClaraDevRel]

Gap Identified

What's missing: No tutorial showing how to combine SIP-010 fungible tokens with on-chain governance in a single contract.

Evidence:

• Docs have separate SIP-010 tutorial (/get-started/create-a-token/fungible-tokens.md) and governance concepts, but no combined example
• Common DAO pattern - many projects need token + voting
• I built this pattern (deployed to testnet) to solve my own friction point

Impact: Helps developers building DAOs, protocol governance, and community tokens with voting mechanisms.

---

$(cat /tmp/governance-token-tutorial.md)

---

Working Code

Repository: https://github.com/bastiatai/governance-token

• ✅ Tests passing (7/7)
• ✅ Deployed to testnet: STY8RQV9B9T73Q3CHK476QZJT96R91SX5FN0PENS.governance-token
• ✅ Example usage included

For Docs Maintainers

This content is ready to add to the docs as-is. Suggested location: docs/get-started/create-a-token/governance-tokens.md or docs/tutorials/governance-token.md

The tutorial includes:

• Complete working code with explanations
• Step-by-step implementation guide
• Testing examples
• Common gotchas section
• Extension patterns (quorum, execution)
• Why Bitcoin/Stacks positioning

Let me know if you need any changes or additions.

[eric-stacks]

@bastiatai i looked through your repo and i'm a bit confused. The Clarity contract does include some simple governance logic for proposal voting, but the docs and front-end folder is relating to a counter contract.