Skip to main content

Welcome to Cajas Documentation

Build and deploy a provably fair case opening platform with real-time animations, cryptographic verification, and secure user authentication.

Get StartedAPI Reference
Cajas Logo

Quick start

Get your Cajas platform up and running in minutes

1

Clone the repository

Clone the Cajas repository and install dependencies:
git clone https://github.com/Shermie80/cajas.git
cd cajas
npm install
2

Set up Supabase

Create a Supabase project and configure your environment variables:
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
Run the database migrations to set up tables for users, cases, items, and transactions.
3

Run the development server

Start the Next.js development server:
npm run dev
Open http://localhost:3000 to see your case opening platform.
4

Open your first case

Create a user account, load virtual currency into your wallet, and open your first case to see the provably fair system in action with real-time animations.

Explore features

Everything you need to build a transparent case opening platform

Provably Fair System

Cryptographic verification using HMAC-SHA256 ensures every case opening is transparent and verifiable

Case Opening

Real-time animated case opening with sound effects and rarity-based reward distribution

Wallet System

Virtual currency management with deposits, balance tracking, and transaction history

User Inventory

Manage won items with status tracking, selling capabilities, and inventory management

Admin Panel

Create and manage cases, configure items, set drop rates, and monitor platform activity

Authentication

Secure user authentication powered by Supabase with profile management

Built with modern technologies

Powered by industry-leading frameworks and tools

Next.js 16

Server-side rendering, API routes, and optimized performance with React 19

Supabase

PostgreSQL database, authentication, and real-time subscriptions

Tailwind CSS

Utility-first CSS with Framer Motion for smooth animations

Explore documentation

Comprehensive guides for users, developers, and administrators

User Guide

Learn how to authenticate, open cases, manage your inventory, and handle your wallet

Read guide

Admin Guide

Configure cases, manage items, set drop rates, and monitor platform activity

Read guide

Technical Reference

Deep dive into architecture, provably fair algorithms, and API endpoints

Explore docs

Deployment

Set up your environment, configure Supabase, and deploy to production

Deploy now

Ready to get started?

Deploy your own provably fair case opening platform and start building trust with your users through transparent, verifiable randomness.

Start Building Now