Quick Links: Live Demo • Setup Guide • Technical Maps • Contribute
BrainBytes uses a distributed architecture to handle code execution and real-time updates.
sequenceDiagram
participant U as User (Frontend)
participant A as Next.js Server Action
participant J as Judge0 API
participant P as Pusher
participant DB as PostgreSQL (Drizzle)
U->>A: Submit Solution
A->>J: POST /submissions
J-->>A: Execution Result
par Sync Data & Notify
A->>DB: Record Stats & $BYTE Rewards
A->>P: Emit Real-time Update
end
P-->>U: Update UI (Result, XP, Tokens)
How the platform interacts with the Sepolia Testnet for rewards.
| Layer | Component | Description |
|---|---|---|
| Provider | Wagmi / RainbowKit | Manages wallet connections and Web3 hooks |
| Logic | Ethers.js / Hardhat | Handles smart contract interaction and gas management |
| Contract | ByteToken (ERC-20) | Deployed on Sepolia for gamified token minting and rewards |
Simplified view of the BrainBytes modular architecture.
├── src/
│ ├── app/ # Next.js App Router (Pages & Layouts)
│ ├── components/ # UI components (shadcn/ui)
│ ├── actions/ # Server Actions (Logic & Mutations)
│ ├── db/ # Drizzle ORM Schema & Migrations
│ ├── lib/ # Shared utilities (Pusher, Auth0, Wagmi)
│ └── contracts/ # Solidity Smart Contracts (Hardhat)
├── documentation/ # Modular Documentation 📄
└── scripts/ # Database Seeding & Deployments
To make it easier for contributors, we have moved detailed specs to the documentation/ folder:
- 🚀 Installation & Setup - Get the project running locally.
- 🔐 Security Architecture - Auth0 patterns & CI/CD scanning.
- 📚 Learning Curriculum - Python/JS DSA path details.
- 🔄 CI/CD Pipelines - GitHub Actions workflows.
We love community help! Check our Contributing Guide for ECWOC'26 guidelines.
MIT Licensed | © 2024-2026 Gaurav Karakoti