Krowdovi MVP

Indoor Navigation DePIN Platform

Blockchain-powered platform paying videographers to create first-person navigation videos for complex indoor spaces like hospitals, airports, and malls.

🎯 Overview

Krowdovi applies burn-and-mint tokenomics to the $7B indoor navigation market. Users burn tokens for navigation credits while creators earn from the remint pool based on their content's usage and reputation.

Key Features

• Motion-Controlled Playback: Video plays when walking, pauses when stopped
• Multi-language Overlays: AI-powered translation for navigation arrows and text
• Creator Studio: Drag-and-drop overlay editor for navigation videos
• Burn-and-Mint Tokenomics: 75% burned, 25% to creator rewards
• Reputation System: 5-tier system with earnings multipliers (0.5x - 2.5x)
• NFC/QR Access: Tap or scan to start navigation instantly

📦 Architecture

wayfind-mvp/
├── packages/
│   ├── api/           # Express 5 backend
│   ├── web/           # Next.js 14 frontend
│   ├── contracts/     # Solana Anchor programs
│   └── shared/        # TypeScript types
└── scripts/           # Deployment utilities

Tech Stack

| Layer | Technology | |-------|------------| | Frontend | Next.js 14, React 18, Tailwind CSS, Framer Motion | | Backend | Express 5, Prisma, PostgreSQL, Redis | | Blockchain | Solana, Anchor, SPL Token | | Video | Cloudflare Stream (HLS), hls.js | | Auth | Solana Wallet Adapter, JWT |

🚀 Quick Start

Prerequisites

• Node.js 22.x
• pnpm 8.x
• PostgreSQL 16.x
• Solana CLI (for contracts)

Installation

# Clone repository
git clone [https://github.com/daftpixie/krowdovi]
cd krowdovi

# Install dependencies
pnpm install

# Setup environment
cp packages/api/.env.example packages/api/.env
cp packages/web/.env.example packages/web/.env

# Run database migrations
cd packages/api
pnpm prisma migrate dev

# Start development servers
pnpm dev

Environment Variables

API (packages/api/.env)

DATABASE_URL=postgresql://...
REDIS_URL=redis://...
JWT_SECRET=your-secret-key
CLOUDFLARE_ACCOUNT_ID=xxx
CLOUDFLARE_API_TOKEN=xxx
SOLANA_RPC_URL=https://api.devnet.solana.com
ANTHROPIC_API_KEY=xxx

Web (packages/web/.env)

NEXT_PUBLIC_API_URL=http://localhost:3001/api/v1
NEXT_PUBLIC_SOLANA_NETWORK=devnet

📊 Tokenomics

Burn-and-Mint Model

When users purchase navigation credits:

• 75% burned (permanently destroyed)
• 25% to remint pool (distributed weekly to creators)
• 500K weekly cap on reminted tokens

Creator Tiers

| Tier | Score Range | Multiplier | |------|-------------|------------| | Bronze | < 40 | 0.5x | | Silver | 40-59 | 1.0x | | Gold | 60-79 | 1.5x | | Platinum | 80-94 | 2.0x | | Diamond | 95+ | 2.5x |

Reputation Metrics

• Freshness (30%): Recent video updates
• Completion Rate (25%): Users finishing navigation
• User Rating (25%): 5-star feedback
• Accessibility (10%): Overlay quality
• No Bounce (10%): Session retention

🎬 Creator Studio

The overlay editor supports:

• Navigation Arrows: 10 directions with distance
• Text Popups: Multi-language with TTS
• Landmarks: POI markers with icons
• Warnings: 4 severity levels
• Advertisements: Revenue-sharing spots
• Destinations: Arrival confirmations

Overlay Properties

• Position (x/y percentage)
• Timing (start/end with fades)
• Scale and rotation
• Haptic feedback patterns
• Accessibility (ARIA, TTS)

📱 Navigation Experience

Access Methods

1. NFC Tag: Tap NTAG213 to start
2. QR Code: Scan to open navigation
3. Direct Link: Share URL
4. App Clip: iOS instant experience

Motion Detection

• DeviceMotion API at 50Hz
• 0.3g walking threshold
• 1.5s sustained to confirm walking
• 2.0s stopped to pause

Accessibility

• Text-to-speech for overlays
• Haptic feedback patterns
• High contrast overlays
• Multi-language support (11+)

🔌 API Endpoints

Authentication

• POST /auth/challenge - Get signing challenge
• POST /auth/verify - Verify wallet signature
• GET /auth/me - Get current user

Videos

• GET /videos - List with filters
• GET /videos/:id - Get with overlays
• POST /videos - Create new video
• POST /videos/:id/rate - Submit rating

Overlays

• GET /overlays?videoId=X - List for video
• POST /overlays - Create overlay
• POST /overlays/bulk - Batch create
• PATCH /overlays/:id - Update

Tokens

• GET /tokens/config - Get tokenomics config
• POST /tokens/burn - Record burn event
• POST /tokens/distribute - Weekly distribution
• POST /tokens/claim - Claim rewards

🏗️ Deployment

Railway Setup

# Login to Railway
railway login

# Create project
railway init

# Add services
railway add -s api
railway add -s web
railway add -s postgres
railway add -s redis

# Deploy
./scripts/deploy.sh production

Solana Deployment

cd packages/contracts

# Build program
anchor build

# Deploy to devnet
anchor deploy --provider.cluster devnet

# Deploy to mainnet
anchor deploy --provider.cluster mainnet

🧪 Testing

# API tests
cd packages/api
pnpm test

# Web tests
cd packages/web
pnpm test

# Contract tests
cd packages/contracts
anchor test

📄 License

MIT License - see LICENSE

🤝 Contributing

1. Fork the repository
2. Create feature branch (git checkout -b feature/amazing)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing)
5. Open Pull Request

---

Built with ❤️ for the 24HRMVP ecosystem