SecretBee is a real-time, interactive web application designed to power live competitions, classroom quizzes, and academic engagement experiences.

Originally inspired by national spelling bee competitions, SecretBee has evolved into a multi-purpose academic competition engine that can be used for:

• 🐝 Spelling Bee preparation & live competitions
• 🏫 Classroom quizzes and student engagement
• 🧮 Math competitions
• 📚 History & English quizzes
• 🧠 Academic tournaments
• 🏆 School-wide or district-wide challenges

Host page:

Player page:

Built with Next.js, React, Node.js, Express, and Socket.IO, SecretBee delivers instant real-time interaction between host and participants.

• Create live rooms with unique codes
• Control question flow in real-time
• Start/stop rounds instantly
• Customize topics (Spelling, Math, History, etc.)

• Join via secure room code
• Submit answers instantly
• Compete live against others
• Receive immediate feedback

The host has full control and visibility:

• 👁 View all participant submissions
• 📈 See live grades and scoring
• 📝 Review individual inputs
• 🏆 Award prizes and declare winners
• 🥇 Handle tie-breakers (fastest correct answer wins)

• No page refreshes
• Live answer validation
• Real-time scoreboard updates
• Seamless multi-user synchronization

• Room-based session isolation
• Real-time state management
• Designed to scale for large competitions

SecretBee is not limited to spelling competitions.

• Practice words by difficulty level
• Host school competitions
• Simulate national-level experiences

• Interactive quizzes during lectures
• Weekly review competitions
• Exit-ticket assessments
• Gamified participation

• Math problem solving rounds
• History trivia contests
• English grammar challenges
• SAT / ACT practice drills

• Assembly competitions
• Multi-class tournaments
• Academic bowl simulations
• Remote competitions

Client (Next.js + React)
        │
        │  Socket.IO (Client)
        ▼
Backend (Node.js + Express)
        │
        │  Socket.IO (Server)
        ▼
Room Management + Answer Validation + Grading Engine

1. Host creates a room.
2. Participants join using a room code.
3. Host presents a question.
4. Participants submit answers live.
5. System validates submissions.
6. Scores update instantly.
7. Host reviews grades and awards prizes.

If there’s a tie — 🏁 the fastest correct submission wins.

git clone https://github.com/your-username/secretbee.git
cd secretbee

npm install
cd client && npm install
cd ..

# Start backend
npm run server

# Start frontend
npm run dev

Frontend runs on:

http://localhost:3000

Backend runs on:

http://localhost:5000

/client          → Next.js + React Frontend
/server          → Express + Socket.IO Backend
/shared          → Shared Types & DTOs
/docker          → Container configuration

• 🥇 Global leaderboard
• ⏱ Built-in countdown timers
• 🎨 Custom themes for classrooms
• 📊 Exportable grade reports (CSV/PDF)
• 🏫 Multi-class dashboards
• 📱 Mobile optimization
• 🌎 Public competition mode

SecretBee can be deployed via:

• AWS EC2 (Dockerized)
• Auto Scaling Group + ALB
• Vercel (Frontend)
• Render / Railway (Backend)
• Kubernetes (Advanced deployments)

Pull requests are welcome.

For major changes, open an issue first to discuss improvements or feature proposals.

MIT License

SecretBee transforms competitions and classrooms into interactive, engaging, and measurable experiences.

It is not just a spelling bee app.

It is a real-time academic competition engine.