VibeBox

AI-powered coding server platform built on Happy open-source project (MIT License).

Overview

A mobile-first AI coding platform that provides subscription-based coding environments with native mobile apps and web access. Differentiates from desktop-focused competitors by prioritizing mobile vibe coding experience.

Core Value

• Mobile-First Experience: Native iOS/Android apps optimized for mobile coding scenarios, with web as secondary platform
• Ready to Use: Pre-configured with Claude Code, Happy CLI, and development tools
• Zero Config: No need to manually configure API keys or development environment
• Seamless Access: Single unified client across all platforms - no app switching or OAuth redirects
• Subscription-based: Monthly/yearly subscription with included Claude API quota

Technical Approach

Zero Modification Solution - Core principles:

• ✅ No modification to happy-server - Uses native API only
• ✅ No modification to happy-cli - Integration via configuration files
• ✅ Customize client only - Based on happy-client with enhancements

See docs/implementation/zero-modification-solution.md for details.

Project Structure

.
├── client/                        # Expo/React Native client (based on happy-client)
│   ├── sources/                  # Application code
│   │   ├── app/                 # Expo Router pages
│   │   ├── components/          # UI components
│   │   ├── auth/                # Authentication
│   │   ├── sync/                # Real-time sync
│   │   └── platform/            # Commercial features (subscriptions, etc.)
│   └── package.json
│
├── server/                        # Next.js backend
│   ├── app/
│   │   ├── api/                 # API Routes
│   │   └── admin/               # Admin dashboard
│   ├── lib/                     # Utilities
│   ├── components/              # React components
│   └── package.json
│
├── shared/                        # Shared types between client and server
│   └── types/
│
├── docs/                          # Documentation
│   ├── design/                   # Design documents
│   ├── research/                 # Research documents
│   ├── implementation/           # Implementation plans
│   └── verification/             # Verification documents
│
├── verify-happy-integration.js   # Verification script (important tool)
│
├── happy-cli/                     # Happy CLI reference (excluded in .gitignore)
├── happy-server/                  # Happy Server reference (excluded)
└── happy-client/                  # Happy Client reference (excluded)

Quick Start

Requirements

• Node.js >= 20
• Yarn (recommended)
• Git

Client (Expo/React Native)

cd client
yarn install
yarn start          # Start Expo development server
yarn ios            # Run on iOS simulator
yarn android        # Run on Android emulator
yarn web            # Run in web browser

Server (Next.js)

cd server
yarn install
yarn dev            # Start development server
yarn build          # Build for production
yarn start          # Start production server

Verification Script

To verify the zero-modification solution:

# Install dependencies
npm install tweetnacl tweetnacl-util axios

# Step 1: Create Happy account
node verify-happy-integration.js step1

# Step 2: Configure CLI (follow step1 output)
node verify-happy-integration.js step2 --token "YOUR_TOKEN" --secret "YOUR_SECRET"

# Step 3: Generate Web URL (follow step2 output)
node verify-happy-integration.js step3 --token "YOUR_TOKEN" --secret "YOUR_SECRET"

See docs/verification/guide.md for detailed guide.

Documentation

Design Phase

• Product Requirements (PRD) - Core features and user journeys
• White Paper - Project vision and requirements

Architecture Decisions

• ADR 001: Client Technology Stack - Mobile-first architecture rationale
• ADR 002: Authentication Solution - Logto authentication and authorization

Research Phase

• Authentication System Analysis - In-depth analysis of Happy authentication
• Web Integration Analysis - Web integration approach comparison

Implementation Phase

• Zero Modification Solution - Complete implementation plan and code
• Verification Guide - Manual verification steps
• Verification Results - Verification outcomes

Development Roadmap

Phase 1: Preparation (Completed)

• ✅ Technical research
• ✅ Solution design
• ✅ Feasibility verification
• ✅ Project structure initialization

...