https://github.com/rithvik119am/vidharith
AI-powered quiz application for educators to create, analyze, and manage quizzes with real-time insights.
https://github.com/rithvik119am/vidharith
ai clerk convex education gemini-flash llm nextjs nextjs14 quiz real-time realtime tyepscript vercel
Last synced: 4 months ago
JSON representation
AI-powered quiz application for educators to create, analyze, and manage quizzes with real-time insights.
- Host: GitHub
- URL: https://github.com/rithvik119am/vidharith
- Owner: Rithvik119am
- Created: 2025-05-01T20:34:31.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-05-24T09:01:20.000Z (4 months ago)
- Last Synced: 2025-05-24T09:31:48.087Z (4 months ago)
- Topics: ai, clerk, convex, education, gemini-flash, llm, nextjs, nextjs14, quiz, real-time, realtime, tyepscript, vercel
- Language: TypeScript
- Homepage: https://vidharith.vercel.app
- Size: 4.28 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Vitharith - AI-Powered Quiz Platform for Educators
[](https://opensource.org/licenses/MIT)
[](https://vidharith.vercel.app/)
[](https://nextjs.org/)
[](https://www.convex.dev/)
[](https://www.typescriptlang.org/)
Vitharith is a modern, AI-powered quiz platform designed to help educators gain real-time insights into student comprehension. The platform enables teachers to create, distribute, and analyze quizzes with powerful AI-assisted features.
🔗 **Live Demo:** [https://vidharith.vercel.app/](https://vidharith.vercel.app/)
## 🚀 Features
### For Educators
- **Interactive Quiz Creation**: Build custom quizzes with various question types
- **Real-time Analytics Dashboard**: Monitor student responses as they happen
- **AI-Powered Question Generation**: Automatically generate questions from uploaded materials
- **Comprehensive Student Insights**:
- Individual student performance analysis
- Class-wide performance metrics
- Topic-wise strength and weakness identification
- **Material Management**: Upload and organize teaching materials in one place
### Technical Highlights
- **Real-time Data Sync**: Instant updates across all devices
- **AI Integration**: Leverages Google's Generative AI for question generation
- **Responsive Design**: Works seamlessly on desktop and mobile devices
- **Secure Authentication**: Built with Clerk for secure user management
## 🛠️ Tech Stack
### Frontend
- **Framework**: Next.js 14 (App Router)
- **UI Components**: Radix UI Primitives and Shadcn UI
- **Styling**: Tailwind CSS with custom theming
- **State Management**: React Hooks + Convex
- **Form Handling**: React Hook Form with Zod validation
- **Charts & Visualizations**: Recharts
### Backend
- **Database & Real-time Sync**: Convex
- **Authentication**: Clerk
- **AI/ML**: Google Generative AI
- **API Routes**: Next.js API Routes
### Development Tools
- **Type Safety**: TypeScript
- **Code Formatting**: ESLint + Prettier
- **Version Control**: Git
- **Package Manager**: npm
## 🚀 Getting Started
### Prerequisites
- Node.js 18+
- npm or yarn
- Convex account
- Google Cloud account (for AI features)
### Installation
1. Clone the repository
```bash
git clone https://github.com/yourusername/vitharith.git
cd vitharith
```
2. Install dependencies
```bash
npm install
# or
yarn
```
3. Set up Convex
```bash
# Install Convex CLI globally if you haven't already
npm install -g convex
# Log in to Convex
npx convex init
# Push your schema and functions to Convex
npx convex dev
```
4. Set up environment variables
Create a `.env.local` file in the root directory and add the following variables:
```env
# Convex
CONVEX_DEPLOYMENT=your_convex_deployment
NEXT_PUBLIC_CONVEX_URL=your_convex_url # Get this from Convex dashboard after setup
# Clerk Authentication
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
CLERK_SECRET_KEY=your_clerk_secret_key
# Google AI
GOOGLE_AI_KEY=your_google_ai_key
# Application
NEXT_PUBLIC_WEBSITE_URL=http://localhost:3000
```
After running `npx convex dev`, it will provide you with the `NEXT_PUBLIC_CONVEX_URL` that you need to add to your environment variables.
4. Run the development server
```bash
npm run dev
# or
yarn dev
```
5. Open [http://localhost:3000](http://localhost:3000) in your browser
## 📊 Features in Action
### Quiz Creation
### Real-time Analytics
### AI Question Generation
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## 📄 License
Distributed under the MIT License. See `LICENSE` for more information.
## 📧 Contact
K. Sai Rithvik Reddy - [@DSToday1](https://x.com/DSToday1) - rithvikreddy524@gmail.com
Project Link: [https://github.com/Rithvik119am/VidhaRith](https://github.com/Rithvik119am/VidhaRith)
## 🙏 Acknowledgments
- [Next.js Documentation](https://nextjs.org/docs)
- [Convex Documentation](https://docs.convex.dev/)
- [Tailwind CSS](https://tailwindcss.com/docs)
- [Radix UI](https://www.radix-ui.com/)
- [Shadcn UI](https://ui.shadcn.com/)