Mystery Gift Developer Documentation

Internal documentation for the Mystery Gift platform team.

Overview

This is the developer documentation for Mystery Gift platform infrastructure. For public documentation, see the main docs site.

Quick Links

• Environment Setup - Get the dev environment running
• Architecture - System architecture overview
• Deployment - Production deployment guide

Repository Structure

mystery-gift/
├── apps/                 # Main applications
│   ├── docs/            # Public documentation (MkDocs)
│   ├── dev-docs/        # Developer documentation (MkDocs)
│   ├── landing/          # Landing page
│   ├── livestream/
│   │   ├── server/      # 24/7 raffle daemon
│   │   └── overlay/     # OBS stream overlay
│   └── marketplace/
│       ├── api/         # Cloudflare Worker backend
│       └── client/      # React web client
├── packages/            # Shared packages
│   ├── blockchain/      # Solana utilities
│   ├── database/        # Prisma + SQLite/D1
│   └── randomness/      # Randomness providers
├── services/            # TEE services
│   ├── verifiable-randomness-service/
│   ├── verifiable-wallet-service/
│   └── miss/            # Miss AI agent
└── scripts/             # Utility scripts

Getting Started

1. Clone the repository with submodules:

git clone --recurse-submodules https://github.com/anomalyco/mystery-gift.git
cd mystery-gift

1. Install dependencies:

pnpm install

1. Generate Prisma client:

cd packages/database && pnpm prisma:generate

1. Run database migrations:

pnpm prisma:migrate dev

1. Start development:

   pnpm dev
   

Contributing

See the GitHub repository for contribution guidelines.