Overview
Dheeyudha is a real-time competitive quiz platform designed for Indian students and teachers. It blends social features (profiles, follows, leaderboards) with academic content (teacher-posted questions, subject-based quizzes) to make learning engaging and competitive.
Competitive Quizzes
Challenge other students in real-time quiz battles, earn points, and climb the leaderboard.
Teacher-Curated Content
Verified teachers post questions across subjects and grades that students can attempt anytime.
Social Learning
Follow students and teachers, see who you're following, and build your academic network.
Global Leaderboard
A live global ranking board that tracks every student's performance and rewards top scorers.
Subject Mastery
Track how many subjects you've mastered and view your overall progress in a visual dashboard.
Secure & Private
Built on Supabase with Row-Level Security — your data is always protected.
Getting Started
Creating an Account
- 1Go to /signup and enter your full name, email, and password.
- 2Choose a unique username — lowercase, no spaces (e.g.
rahul_sharma). This becomes your public profile URL. - 3Confirm your email through the verification link sent to your inbox.
- 4Sign in at /login and you're in!
Teacher Accounts
Teachers have a separate verification process to maintain content quality. To apply for a Teacher account:
- 1Create a regular student account first.
- 2Visit /teacher/apply and submit your application with subject details.
- 3An admin reviews and approves your application. You'll receive a ✓ Verified Teacher badge once approved.
Student Profile
Your public student profile is accessible at /user/[username]. It showcases your achievements, stats, and social metrics.
Avatar & Banner
Upload a custom profile photo and banner image. Click the edit button on hover to change them. Images are cropped interactively before upload.
Name & Username
Edit your display name or username directly on your profile. Username changes are rate-limited to 4 per month to prevent abuse.
Global Rank Badge
Your current global ranking is always visible on your profile with a bold rank card (Gold / Silver / Bronze / etc.).
Stats Grid
See your Battles Won, Win Rate, Current Streak, and total Points at a glance in a 4-card grid.
Achievements
A visual list of badges you have earned (e.g. First Victory, Battle Master, Quiz Genius). Locked achievements are shown greyed out.
Recent Battles
The last three quiz battles you have participated in, showing your opponent, subject, score, and outcome.
Teacher Profile
Teacher profiles are at /teacher/[username]. They display the teacher's identity and all their created questions.
Follow System
Dheeyudha has a full social follow system. You can follow both students and teachers, and see who follows you.
Follow / Unfollow
Click the Follow button on any profile. It toggles with a smooth animation — hover to see the Unfollow state.
Followers & Following Counts
Both counts are displayed prominently below the bio on every profile. The counts update in real-time.
User List Modals
Click on the Followers or Following count to open a modal showing the full list with profile links.
Rules & Notes
- ✓ You can follow both students and teachers.
- ✓ Clicking a user in the followers/following modal navigates directly to their profile.
- — You cannot follow yourself — the Follow button is hidden on your own profile.
- — Following is not mutual: following someone does not automatically make them follow you back.
Leaderboard
The Global Leaderboard ranks all students by their total earned points.
Peer vs Peer (Dheeyudha)
"Dheeyudha" translates to "War of Wits". This is the core competitive feature of Dheeyudha, allowing you to challenge other students to a real-time quiz battle.
Declaring a War
- 1From the homepage, use the "Challenge a Peer" feature to find an opponent. You can search by username or school.
- 2Once you've selected an opponent, you can "Declare War".
- 3The opponent will be notified of your challenge.
Questions
Posting Questions (Teachers Only)
Verified teachers can create questions at /questions/create.
Attempting Questions (Students)
- → Browse all available questions from the home dashboard or teacher profiles.
- → Click Attempt on a question card to start solving it.
- → Submit your answer within the time limit to earn points.
- → Points are automatically added to your total and reflected on the leaderboard.
Deleting Questions
Teachers can delete their own questions using the ⋯ menu on each question card. This is only visible to the question's creator.
Points & Penalties
Dheeyudha uses a completely transparent and fair point system. You are rewarded for correct answers, but to prevent random guessing, higher-value questions carry a risk of negative marking.
Earning Points
Every question posted by a teacher is assigned a specific point value based on its difficulty. Answering the question correctly before the timer runs out awards you the full points, which directly boost your Global Rank.
Flat-Tiered Negative Marking
To maintain leaderboard integrity, incorrect guesses on high-reward questions result in a penalty. Dheeyudha uses a Flat-Tiered Deduction Scale — meaning 1-point questions don't carry harsh penalties, but major questions do.
Achievements
AI Submission Review
Get instant, detailed feedback on your written submissions with our advanced AI-powered review system. This feature helps you understand your mistakes and improve your knowledge without waiting for a human checker.
How It Works
- 1After completing a written question, you can request an AI review for your submission.
- 2Our AI analyzes your answer for correctness, completeness, and clarity based on the question's context.
- 3You receive a detailed report with a score, feedback on what you did right, and suggestions for improvement.
Notifications
Stay up-to-date with everything happening on the platform. The notification system ensures you never miss important events.
Types of Notifications
You will receive notifications for:
- When someone follows you.
- When a teacher you follow posts a new question.
- When your application to become a teacher is approved.
- When you receive a new challenge.
- When you earn a new achievement.
Privacy & Security
Row-Level Security (RLS)
All Supabase tables use RLS policies — users can only read and write their own data. No one can tamper with another user's records.
Supabase Auth
Authentication is handled by Supabase Auth with industry-standard JWT tokens. Passwords are never stored in plain text.
Storage Buckets
Avatars and banners are stored in private Supabase Storage buckets. Only public URLs are exposed — raw bucket paths are never shared.
Admin Operations
Operations like looking up user info server-side use a server-only `supabaseAdmin` client — never exposed to browsers.
Ready to start learning?
Join thousands of students competing and learning on Dheeyudha.