Motivational habit tracking meets blockchain rewards and NFT achievements
Achivio is a comprehensive habit tracking application built on the Stacks blockchain that gamifies healthy habits through token rewards, streak bonuses, NFT achievement badges, and customizable 3D virtual rooms.
| Modern Workspace | Cozy Study | Gaming Setup |
- Daily Habit Tracking - Create and complete custom daily tasks
- ACHIV Token Rewards - Earn fungible tokens for completing habits
- Streak System - Bonus rewards for consecutive day completions
- NFT Achievement Badges - Collectible badges for milestones
- 3D Virtual Rooms - Customize your workspace with earned items
- Social Leaderboards - Compete and compare with other users
Achivio consists of 6 interconnected smart contracts:
| Contract | Status | Purpose | Key Functions |
|---|---|---|---|
| achiv-token | ✅ LIVE | SIP-010 fungible token for rewards | mint-reward, transfer, burn |
| task-tracker | 🔧 Development | Core habit tracking and completion | create-task, complete-task |
| streak-system | 🔧 Development | Consecutive day bonuses and milestones | update-user-streak, claim-streak-bonus |
| nft-badges | 🔧 Development | SIP-009 NFT badges for achievements | mint-streak-badge, mint-task-master-badge |
| room-items | 🔧 Development | SIP-009 NFT virtual furniture/items | purchase-item, place-item-in-room |
| leaderboard | 🔧 Development | User rankings and social features | update-user-stats, compare-users |
🔗 Deployed Contract: ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.achiv-token
🌐 Network: Stacks Testnet
📱 Frontend: http://localhost:3000 (local development)
git clone https://github.com/gorkemsandikci/achivio.git
cd achivio
npm install
# Install Clarinet for contract development
brew install clarinet
# Check contracts
clarinet check
# Run tests
npm testcd frontend
npm install
npm run dev
# Open http://localhost:3000# Create .env file in frontend/
NEXT_PUBLIC_STACKS_NETWORK=testnet
NEXT_PUBLIC_CONTRACT_ADDRESS=ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM# Deploy contracts to testnet
clarinet deployments apply --testnet
# Deploy contracts to mainnet (⚠️ costs real STX)
clarinet deployments apply --mainnet
# Deploy frontend
cd frontend && npm run build- Create Habits - Set up daily tasks with custom rewards
- Complete Tasks - Earn ACHIV tokens for consistency
- Build Streaks - Get bonus rewards for consecutive days
- Earn Badges - Unlock NFT achievements for milestones
- Customize Room - Buy virtual furniture with earned tokens
- Compete Socially - Climb leaderboards and compare progress
npm test # Run all tests
npm test achiv-token.test.ts # Run specific tests
npm run test:coverage # Run with coverage- 70% User Rewards - Daily task completion
- 15% Streak Bonuses - Consecutive achievements
- 10% Development - Platform growth
- 5% Reserve - Emergency fund
Deflationary Mechanics: Tokens burned through room item purchases
- Daily completion limits prevent fraud
- Authorized minter controls
- Emergency pause mechanisms
- Comprehensive access controls
- Fork and clone the repository
- Create a feature branch
- Write tests for new functionality
- Submit a pull request
MIT License - see LICENSE file for details.
- Documentation: docs.achivio.app
- Discord: discord.gg/achivio
- Email: [email protected]
Built with ❤️ on Stacks blockchain