Example dApps

Forkable Scaffold Stacks reference dApps — DropClaim SIP-010 airdrop and StackVote on-chain governance, already deployed on Stacks testnet.

Official forkable reference dApps live in github.com/scaffold-stack/Examples. Each one is a complete Stacks project: Clarity contract, tests, generated React hooks, custom Next.js UI, and a live testnet deployment.

Start here if you want to run a real app before stacksdapp new, or to copy a custom frontend pattern.

Run stacksdapp inside an example folder (airdrop_product/ or votingapp/), not from the repo root.

Examples

App	Directory	What it does
DropClaim	airdrop_product/	SIP-010 token airdrop — claim, mint, transfer
StackVote	votingapp/	On-chain governance — create proposals, vote yes/no

Run on testnet

Contracts are already deployed. You do not need to deploy to try the UI.

git clone https://github.com/scaffold-stack/Examples.git
cd Examples
stacksdapp doctor

1. Start an example

   # DropClaim
   cd airdrop_product && stacksdapp dev --network testnet
   
   # or StackVote
   cd votingapp && stacksdapp dev --network testnet
   
2. Connect a wallet

   Open http://localhost:3000. Install Leather or Xverse, switch to Testnet, fund STX from the Hiro faucet, then click Connect.

To customize and deploy under your own address, fork the repo first.

DropClaim

SIP-010 DROP token (6 decimals). One-time claim of 1,000 DROP per wallet.

Item	Value
Contract	ST3XHHZ1CXVCNYXK3FQ1FDGJ9NK6YBJBJK3FVY5KQ.airdrop-token-v2
Deploy tx	Hiro explorer
Source	contracts/contracts/airdrop-token-v2.clar
Custom UI	frontend/src/components/AirdropApp.tsx

Function	Access	Hook
claim	public	useAirdropTokenV2_Claim
mint	public	useAirdropTokenV2_Mint
transfer	public	useAirdropTokenV2_Transfer
has-claimed	read-only	useAirdropTokenV2_HasClaimed
get-balance	read-only	useAirdropTokenV2_GetBalance

In the UI: claim airdrop, mint extra tokens, transfer DROP.

Trait rules for mainnet listing: SIP standards. Full notes: airdrop.md.

StackVote

On-chain proposals with a yes/no vote. One vote per wallet per proposal.

Item	Value
Contract	ST3XHHZ1CXVCNYXK3FQ1FDGJ9NK6YBJBJK3FVY5KQ.voting-v3
Deploy tx	Hiro explorer
Source	contracts/contracts/voting-v3.clar
Custom UI	frontend/src/components/VotingApp.tsx

Function	Access	Hook
create-proposal	public	useVotingV3_CreateProposal
vote	public	useVotingV3_Vote
get-proposal	read-only	useVotingV3_GetProposal
get-proposal-count	read-only	useVotingV3_GetProposalCount
has-voted	read-only	useVotingV3_HasVoted

In the UI: create a proposal, vote yes or no, refresh tallies.

Full notes: voting.md.

Edit and redeploy

From inside the example directory:

# edit contracts/contracts/*.clar
stacksdapp check && stacksdapp generate && stacksdapp test

Set a testnet-only mnemonic in contracts/settings/Testnet.toml (never commit it), then:

stacksdapp deploy --network testnet --yes
stacksdapp dev --network testnet

If you bump the contract name (for example voting-v3 → voting-v4), update hook imports in the custom UI component.

Deployment details: DEPLOYMENT.md.

Related

Goal	Guide
New project from scratch	Quickstart
Donation jar video	Video tutorial
SIP-010 / SIP-009 templates	SIP standards
Custom hooks and wallet	Frontend
Example repo docs	QUICKSTART.md