Skip to content

SkateHive/monorepo

BranchesTags

Repository files navigation

SkateHive Monorepo 🛹

A comprehensive decentralized platform ecosystem that connects skateboarders worldwide through blockchain technology, social media integration, and distributed media processing infrastructure.

🌟 Vision & Mission

SkateHive is building the future of decentralized skateboarding culture by:

  • Empowering creators with blockchain-based content monetization via Hive blockchain
  • Preserving skateboarding culture through IPFS-based permanent content storage
  • Connecting communities with real-time social features and interactive maps
  • Rewarding participation through cryptocurrency tokens and NFTs
  • Providing infrastructure that runs on accessible hardware (Mac Mini, Raspberry Pi)

🏗️ Architecture Overview

The SkateHive ecosystem operates as a distributed microservices architecture where:

┌─────────────────────────────────────────────────────────────┐
│                    SKATEHIVE3.0 (Next.js)                   │
│              Main Web Application (Vercel)                  │
│     - User Interface & Content Creation                     │
│     - Hive Blockchain Integration                           │
│     - Wallet Management (Hive, Ethereum, Farcaster)         │
└──────────────────┬──────────────────────────────────────────┘
                   │
                   ▼
┌─────────────────────────────────────────────────────────────┐
│            SkateHive Services (Distributed Nodes)           │
│              (Any Server: Cloud, VPS, Self-Hosted)          │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌────────────────┐  ┌────────────────┐  ┌──────────────┐   │
│  │ Video Worker   │  │ Instagram DL   │  │ skatehive-api│   │
│  │ (Transcoding)  │  │ (Social Media) │  │  (Hive API)  │   │
│  └────────────────┘  └────────────────┘  └──────────────┘   │
│                                                             │
│  ┌────────────────┐  ┌────────────────┐                      │
│  │  Dashboard     │  │  Mobile App    │                      │
│  │ (Monitoring)   │  │ (React Native) │                      │
│  └────────────────┘  └────────────────┘                      │
│                                                             │
│  Example Deployments:                                       │
│  • Mac Mini M4 (Primary) • Raspberry Pi (Secondary)         │
│  • Any VPS Provider                                         │
└──────────────────────────┬──────────────────────────────────┘
                           │
                           ▼
                ┌─────────────────────┐
                │   IPFS (Pinata)     │
                │  Permanent Storage  │
                └─────────────────────┘
                           │
                ┌──────────┴──────────┐
                ▼                     ▼
           ┌─────────-┐          ┌──────────┐
           │  Hive    │          │ Ethereum │
           │Blockchain│          │ Network  │
           └─────────-┘          └──────────┘

Network Architecture

  • Tailscale Mesh Network: Secure peer-to-peer connectivity between all infrastructure nodes
  • Funnel Public Access: HTTPS endpoints exposed via Tailscale for external API access
  • Flexible Deployment: Services can run on any server (cloud VPS, self-hosted, edge devices)
  • Multi-Tier Fallback: Primary → Secondary → Cloud backup for high availability
  • Auto-Recovery: Power outage resilience with automatic service restart

📁 Repository Structure

🎨 apps/skatehive3.0/ - Main Web Application

Next.js 15 full-stack application - The heart of the SkateHive platform

Key Features:

  • 🔐 Multi-Wallet Support: Hive Keychain, Farcaster, Ethereum (WalletConnect, MetaMask)
  • 📝 Rich Content Creation: Markdown editor with image/video upload, Instagram integration
  • 🎬 Video Processing: Upload, transcode, and publish videos with IPFS storage
  • 📸 Instagram Integration: Direct posting from Instagram with automatic download
  • 🗺️ Interactive Skate Map: Global skateboarding spots with user contributions
  • 💰 Token Economics: HIGHER token, coin creation, trading, and staking
  • 🏆 Leaderboard: User rankings based on Hive Power and engagement
  • 🎨 Magazine/Blog: Long-form content publication system
  • 💬 Social Features: Comments, notifications, follow/unfollow
  • 🎁 Airdrops: Token distribution campaigns
  • 🏛️ DAO Governance: Community-driven decision making
  • 🖼️ Zora Integration: Zora Coin minting, management and trading
  • 📱 Responsive Design: Mobile-first with Farcaster Frame support

Technology Stack:

  • Framework: Next.js 15.3.2 with App Router
  • Styling: Tailwind CSS + Shadcn UI components
  • Database: PostgreSQL (Supabase)
  • Authentication: Multi-provider (Hive, Farcaster, Ethereum)
  • State Management: React Context + TanStack Query
  • Blockchain: Hive.js, Dhive, Viem (Ethereum)
  • Storage: IPFS via Pinata
  • Deployment: Vercel with edge functions

Key Directories:

  • app/ - Next.js 15 app router pages and API routes
  • components/ - Reusable UI components organized by feature
  • lib/ - Utility functions, blockchain integration, API clients
  • services/ - External service integrations (video, Instagram)
  • hooks/ - Custom React hooks for state and effects
  • types/ - TypeScript type definitions
  • sql/ - Database schemas and migrations

🎬 services/skatehive-video-transcoder/ - Video Processing Service

Node.js + FFmpeg service for video optimization and IPFS upload

Features:

  • Format Conversion: Any video → web-optimized H.264/AAC MP4
  • IPFS Upload: Automatic Pinata upload with CID generation
  • File Size Limits: Configurable max upload (currently 200MB)
  • Rich Logging: JSON logs with user info, file details, processing time
  • Statistics API: Success rates, processing metrics, user activity
  • Docker Containerized: Easy deployment and scaling

Technology Stack: Node.js, Express, FFmpeg, Multer, Pinata SDK

API Endpoints:

  • POST /transcode - Upload and process video files
  • GET /healthz - Service health check
  • GET /logs - Recent processing operations (JSON)
  • GET /stats - Aggregated statistics and metrics

Configuration:

  • Port: 8081
  • Max Upload: 200MB (configurable via MAX_UPLOAD_MB)
  • External URL: https://minivlad.tail83ea3e.ts.net/video/transcode

📱 apps/mobileapp/ - React Native Mobile Application

Expo/React Native app for iOS and Android - Native mobile experience for SkateHive

Features:

  • 📱 Native Experience: Optimized for iOS and Android platforms
  • 🔐 Secure Authentication: Encrypted keychain storage for Hive keys
  • 📝 Content Creation: Post photos and videos with IPFS upload
  • 🎬 Video Feed: Dedicated video content browsing
  • 🏆 Leaderboard: Community rankings and engagement metrics
  • 🔔 Notifications: Real-time notification system
  • 👤 Profiles: User profiles with followers/following
  • 📰 Feed: Infinite scroll with following/trending tabs

Technology Stack: React Native, Expo, TypeScript, React Query, @hiveio/dhive

Key Directories:

  • app/ - Expo Router screens and navigation
  • components/ - Reusable UI components
  • lib/ - Hive utilities, upload services, API clients
  • assets/ - Images, fonts, and static files

📱 services/skatehive-instagram-downloader/ - Social Media Content Service

FastAPI service for downloading Instagram/YouTube content with IPFS storage

Features:

  • Multi-Platform: Instagram, YouTube, TikTok, 1000+ sites via yt-dlp
  • Cookie Authentication: Instagram authentication to bypass rate limits
  • IPFS Integration: Automatic Pinata upload with gateway URLs
  • RESTful + Slug API: JSON POST and base64 URL slug support
  • Health Monitoring: Cookie validation and expiration tracking
  • File Management: Configurable retention and size limits (max 1.5GB)

Technology Stack: Python 3.11, FastAPI, yt-dlp, Pinata SDK

API Endpoints:

  • POST /download - Download content via JSON payload
  • GET /d/<base64_slug> - Download via URL slug
  • GET /healthz - Service health with cookie status
  • POST /cookies/validate - Validate Instagram cookies
  • GET /cookies/status - Cookie expiration status

Configuration:

  • Port: 6666 (host) / 8000 (container)
  • Cookie File: data/instagram_cookies.txt (Netscape format)
  • External URL: https://minivlad.tail83ea3e.ts.net/instagram/download (primary via Tailscale Funnel)

🔗 Shared Infrastructure

The webapp (skatehive3.0) consumes shared backend services:

┌─────────────────────────────────────────────────────────────┐
│                    SHARED INFRASTRUCTURE                    │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌──────────────┐     ┌──────────────┐                      │
│  │   Webapp     │     │  Mobile App  │                      │
│  │ (skatehive3.0)     │ (mobileapp)  │                      │
│  └──────┬───────┘     └──────┬───────┘                      │
│         │                    │                              │
│         ▼                    ▼                              │
│  ┌─────────────────────────────────────────┐                │
│  │     api.skatehive.app (skatehive-api)   │                │
│  │  • /api/v1/feed, /api/v1/leaderboard    │                │
│  │  • /api/transcode/status                │                │
│  └─────────────────────────────────────────┘                │
│                      │                                      │
│         ┌────────────┴────────────┐                         │
│         ▼                        ▼                         │
│  ┌──────────────┐         ┌──────────────┐                  │
│  │  Mac Mini M4 │         │ Raspberry Pi │                  │
│  │  Transcoder  │         │  Transcoder  │                  │
│  └──────────────┘         └──────────────┘                  │
│                      │                                      │
│                      ▼                                      │
│  ┌─────────────────────────────────────────┐                │
│  │         ipfs.skatehive.app              │                │
│  │         (IPFS Gateway)                  │                │
│  └─────────────────────────────────────────┘                │
│                      │                                      │
│                      ▼                                      │
│  ┌─────────────────────────────────────────┐                │
│  │         Hive Blockchain Nodes           │                │
│  │  • api.deathwing.me, api.hive.blog      │                │
│  └─────────────────────────────────────────┘                │
│                                                             │
└─────────────────────────────────────────────────────────────┘

🏗️ Backend APIs (skatehive-api)

Endpoint Description Webapp Mobile
/api/v1/feed Main community feed ✅ ✅
/api/v2/feed Enhanced feed (v2) ✅ ❌
/api/v1/leaderboard Community leaderboard ✅ ✅
/api/v1/balance/{user} User balance data ✅ ✅
/api/v1/balance/{user}/rewards User rewards ✅ ✅
/api/v1/feed/{user}/following Following feed ✅ ✅
/api/transcode/status Video transcoding status ✅ ✅

🎬 Video Transcoding (with failover)

Service URL Priority
Mac Mini M4 (Primary) minivlad.tail83ea3e.ts.net/video/transcode 1
Raspberry Pi (Secondary) vladsberry.tail83ea3e.ts.net/video/transcode 2

All servers run the same skatehive-video-transcoder codebase. Additional servers can be added by deploying the same service.

🔗 Other Shared Services

Service URL Purpose
IPFS Gateway ipfs.skatehive.app/ipfs/{cid} Decentralized media storage
Hive Images images.hive.blog/{user}/{sig} Image upload & avatars
Community Tag hive-173115 Skatehive community identifier

⛓️ Shared Hive Nodes

Both apps use the same Hive RPC nodes: api.deathwing.me, techcoderx.com, api.hive.blog, anyx.io, hive-api.arcange.eu, hive-api.3speak.tv

📊 Webapp vs Mobile Feature Comparison

Feature Webapp Mobile Notes
Core
Feed (infinite scroll) ✅ ✅ Mobile uses v1 API
Video feed ✅ ✅
Leaderboard ✅ ✅
Notifications ✅ ✅
Profile view ✅ ✅
Create posts ✅ ✅
Comments/Replies ✅ ✅
Following/Trending ✅ ✅
Wallet & Crypto
Full Wallet ✅ ⚠️ Disabled for App Store
Ethereum/NFTs ✅ ❌
Swap functionality ✅ ❌
Send tokens ✅ ❌
SkateBank ✅ ❌
Portfolio charts ✅ ❌
Community Features
Spot Map ✅ ❌
Bounties ✅ ❌
DAO/Governance ✅ ❌
Chat ✅ ❌
Auction system ✅ ❌
Airdrop system ✅ ❌
Profile Management
Edit profile ✅ ❌
Video parts ✅ ❌
Merge accounts ✅ ❌
Content Creation
Beneficiaries ✅ ❌
Full markdown editor ✅ ⚠️ Basic in mobile
Thumbnail picker ✅ ❌
Other
Magazine ✅ ❌
Game ✅ ❌
Witness voting ✅ ❌
Zora/Coin trading ✅ ❌

🔄 Service Integration Flow

Content Processing Pipeline

  1. Content Acquisition: skatehive-instagram-downloader fetches media from social platforms
  2. Video Processing: skatehive-video-transcoder optimizes videos for web delivery
  3. IPFS Storage: Both services upload processed content to decentralized storage
  4. Frontend Display: skatehive3.0 presents content to users with blockchain integration

Monitoring & Operations

  1. Health Monitoring: skatehive-dashboard continuously monitors all backend services
  2. Performance Tracking: Real-time metrics, response times, and resource usage
  3. Log Aggregation: Centralized logging from all services for debugging and analytics
  4. Automated Alerts: Service downtime and performance degradation detection

Data Flow Architecture

External Content → Instagram Downloader → Video Transcoder → IPFS Storage
                                              ↓
User Uploads ────────────────────────────→ Video Transcoder → IPFS Storage
                                              ↓
All Services ←─────────── Dashboard Monitoring ←─────────── Main App (skatehive3.0)

🚀 New Contributor? Start Here

This is a hybrid monorepo — the root tracks docs, scripts, and config, while each app/service lives in its own Git repository. The setup script handles everything for you.

# 1. Clone this repo
git clone git@github.com:SkateHive/monorepo.git skatehive-monorepo
cd skatehive-monorepo

# 2. Run the interactive setup (clones all repos, installs deps, configures services)
./setup.sh

That's it. The setup wizard will:

  1. Check dependencies — git, docker, node, pnpm, etc.
  2. Configure your node — name, role, ports, API keys
  3. Clone all 6 repositories into apps/ and services/ (SSH with HTTPS fallback)
  4. Build services — video transcoder, instagram downloader (Docker)
  5. Setup networking — Tailscale Funnel (optional)
  6. Configure auto-start — power recovery scripts (optional)

Prerequisites

You'll need these installed before running ./setup.sh (the script will tell you what's missing):

  • Git
  • Docker & Docker Compose
  • Node.js 18+
  • pnpm (npm install -g pnpm)

Optional (the script will skip if not present):

  • Tailscale (for mesh networking between nodes)
  • Pinata account with JWT token (for IPFS uploads)

What gets cloned

Directory Repository Description
apps/skatehive3.0/ SkateHive/skatehive3.0 Next.js web app
apps/mobileapp/ SkateHive/mobileapp React Native mobile app
apps/skatehive-docs/ SkateHive/skatehive-docs Documentation site
services/skatehive-api/ SkateHive/skatehive-api Backend API
services/skatehive-video-transcoder/ SkateHive/video-transcoder FFmpeg video processing
services/skatehive-instagram-downloader/ SkateHive/skatehive-instagram-downloader Social media downloader

These directories are git-ignored by the root repo — each has its own independent git history.

Running individual services after setup

# Web app (development)
cd apps/skatehive3.0 && pnpm install && pnpm dev

# Video transcoder (Docker)
cd services/skatehive-video-transcoder && docker compose up -d

# Instagram downloader (Docker)
cd services/skatehive-instagram-downloader/ytipfs-worker && docker compose up -d

Manual clone (if you prefer not to use setup.sh)

Click to expand manual setup instructions 
git clone git@github.com:SkateHive/monorepo.git skatehive-monorepo
cd skatehive-monorepo

mkdir -p apps services
git clone git@github.com:SkateHive/skatehive3.0.git apps/skatehive3.0
git clone git@github.com:SkateHive/mobileapp.git apps/mobileapp
git clone git@github.com:SkateHive/skatehive-docs.git apps/skatehive-docs
git clone git@github.com:SkateHive/skatehive-api.git services/skatehive-api
git clone git@github.com:SkateHive/video-transcoder.git services/skatehive-video-transcoder
git clone git@github.com:SkateHive/skatehive-instagram-downloader.git services/skatehive-instagram-downloader

Then copy and edit the config:

cp skatehive.config.example skatehive.config
# Edit skatehive.config with your values

Syncing an existing installation

If you already have the repos cloned, just run ./setup.sh again — it detects existing repos and offers to update them instead of re-cloning.

Environment Configuration

Critical environment variables across services:

  • PINATA_JWT - IPFS storage authentication
  • HIVE_POSTING_KEY - Blockchain integration
  • NEXT_PUBLIC_* - Frontend configuration
  • Service-specific ports and endpoints

🛠️ Development & Deployment

This monorepo is designed for self-hosted deployment (Mac Mini, Raspberry Pi, cloud VPS) with:

  • Containerized services for easy management
  • Resource-optimized configurations
  • Health monitoring and auto-recovery
  • Modular architecture for independent scaling

Each service can be developed and deployed independently while maintaining integration through well-defined APIs and shared storage systems.

📊 Monitoring & Maintenance

The dashboard provides comprehensive monitoring including:

  • Service uptime and response times
  • Resource utilization (CPU, memory, disk)
  • Processing statistics and success rates
  • Real-time log streaming and error tracking
  • Internet connectivity and speed monitoring

🤝 Contributing

Each subdirectory contains its own development guidelines. The modular architecture allows for independent development while maintaining system integration through standardized APIs and monitoring interfaces.

About

No description, website, or topics provided.

Resources

Readme
Activity
Custom properties

Stars

1 star

Watchers

1 watching

Forks

3 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages