๐ฎ RWA Tycoon - Gamified Real-World Asset Learning for Kids: https://tinyassets.vercel.app/
Learn about real-world assets through fun, interactive gameplay!
Property, Solar Farms, and Gold โ discover how they work without any real money or risk.
RWA Tycoon is an educational game that teaches kids about real-world assets (RWAs) through an engaging, Duolingo/Pokรฉmon-style experience. Kids learn by playing: making investment decisions, experiencing market events, earning XP and badges, and watching their portfolio growโall in a safe, educational environment.
- ๐ Three Asset Types: Property, Solar Farms, and Gold
- ๐ฒ Daily Gameplay Loop: Morning indicators โ Midday decisions โ Evening results โ Night missions
- ๐ Gamification: XP system, levels, tokens, badges, and daily missions
- ๐ Win Conditions: Reach Level 5, earn 100 tokens, or achieve 100% ownership
- ๐จโ๐ฉโ๐งโ๐ฆ Parent Dashboard: Parents can view their child's progress using a unique parent code
- ๐ Educational Events: Real-world scenarios (heatwaves, economic changes, crises) affect assets differently
- ๐ Morning Phase - View market indicators for the day
- ๐ Midday Phase - Make investment decisions (buy, sell, or hold shares)
- ๐ Evening Phase - See results: production earnings and events
- ๐ Night Phase - Complete missions, claim rewards, and view progress
- Tokens: Earned through asset production and lost/gained during events
- XP & Levels: Gain experience points by playing daily and completing missions
- Badges: Unlock achievements as you reach milestones
- Share-Based Ownership: Buy 1-4 shares per asset (up to 100% ownership)
- Event System: Real-world events affect different assets in meaningful ways
- Frontend Framework: Next.js 14 (App Router + Pages Router)
- UI Library: React 18
- Styling: Tailwind CSS 3.4
- Database: Supabase (PostgreSQL)
- Backend: Next.js API Routes
- State Management: React Hooks (useState, useEffect)
- Client Storage: localStorage for user session
tinyassets/
โโโ app/ # Next.js App Router
โ โโโ kid/ # Kid's game interface
โ โ โโโ game/ # Main game page (phases, gameplay)
โ โ โโโ asset-choice/ # Asset selection screen
โ โ โโโ asset-detail/ # Individual asset details
โ โโโ layout.js # Root layout
โ
โโโ pages/ # Next.js Pages Router
โ โโโ api/ # API endpoints
โ โ โโโ game/ # Game logic APIs (buy/sell, execute day, etc.)
โ โ โโโ kid/ # Kid-specific APIs (setup, parent code)
โ โ โโโ parent/ # Parent dashboard APIs
โ โ โโโ ai/ # AI assistant integration
โ โโโ parent.js # Parent dashboard page
โ
โโโ lib/ # Shared utilities
โ โโโ gameAPI.js # Client-side API helpers
โ โโโ db-helpers.js # Database operations
โ โโโ gameEngine.js # Game logic
โ โโโ gameRules.js # Rules and calculations
โ โโโ badges.js # Badge system
โ โโโ missions.js # Mission system
โ โโโ mockAssets.js # Asset definitions
โ
โโโ components/ # React components
โ โโโ TutorialFlow.js # First-time tutorial
โ
โโโ backend/ # Backend services & schema
โโโ schema.sql # Database schema
โโโ rules-engine.js # Core game rules
โโโ src/ # Backend service structure
- Property ๐ : Earns daily tokens through rental income
- Solar Farms โ๏ธ: High production, affected by environmental events
- Gold ๐ช: Protects during crisis events (no daily income, but valuable during downturns)
- XP Rewards: Earn XP by completing daily cycles, missions, and events
- Level Up: Unlock new features and missions as you level up
- Token Management: Balance spending on assets vs. saving for goals
- Daily Missions: New challenges each day (Level 2+)
- Achievement Missions: Long-term goals (own all assets, reach milestones)
- Mission Rewards: Earn XP for completing missions
Players can win by achieving any of:
- Level 5 - Reach level 5 through XP progression
- 100 Tokens - Accumulate 100 tokens
- 100% Ownership - Own 4 shares of each asset (12 total shares)
- Bright, Kid-Friendly Design: Colorful gradients, playful animations
- Phase-Based Backgrounds: Each time of day has its own theme color
- Intuitive Navigation: Clear buttons and visual feedback
- Parent Code Display: Always visible on login screen for easy sharing
- Progress Overview: See child's level, XP, tokens, and portfolio
- Learning Summary: View badges earned, events experienced, missions completed
- Secure Access: Login with parent code to view child's progress
- โ No Real Money: Completely educational, no financial transactions
- โ No Wallets: No blockchain or crypto wallet required
- โ Parent Code System: Secure access for parents to view progress
- โ Local Storage: User sessions stored client-side
- โ Read-Only Parent View: Parents can view but not modify game state
- Node.js 18+
- npm or yarn
- Supabase account (for database)
# Clone the repository
git clone <repo-url>
cd tinyassets
# Install dependencies
npm install
# Set up environment variables
# Create .env.local with:
# NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
# NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key
# SUPABASE_SERVICE_ROLE_KEY=your_service_role_key
# Run database migrations (see backend/schema.sql)
# Start development server
npm run devVisit http://localhost:3000 to start playing!
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Kid Interface (Next.js App Router) โ
โ - Morning/Midday/Evening/Night phases โ
โ - Asset management UI โ
โ - Mission & badge displays โ
โโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Game API (Next.js API Routes) โ
โ - /api/game/buy-asset โ
โ - /api/game/sell-asset โ
โ - /api/game/execute-day โ
โ - /api/game/missions โ
โโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Rules Engine (lib/) โ
โ - Game logic & calculations โ
โ - Event processing โ
โ - XP & badge unlocks โ
โโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Supabase (PostgreSQL) โ
โ - game_state โ
โ - user_assets โ
โ - missions, badges, events โ
โโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Parent Dashboard (Read-Only View) โ
โ - Progress tracking โ
โ - Learning analytics โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
RWA Tycoon teaches kids about:
- Real-World Assets: What they are and how they work
- Investment Concepts: Shares, ownership, diversification
- Market Events: How external factors affect asset performance
- Decision Making: Weighing options and seeing consequences
- Long-Term Planning: Saving vs. spending, goal setting
- Risk Management: Different assets behave differently in crises
Potential features for future versions:
- Additional asset types (stocks, bonds, commodities)
- Multiplayer/leaderboard features
- More complex event scenarios
- Educational content library
- Advanced analytics for parents
- Mobile app version
This project is built for educational purposes.
Built with โค๏ธ to make learning about real-world assets fun and engaging for kids!
Special thanks to the educational gaming community for inspiration on gamification and learning design.