Skip to content

phongna07/examvjppro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

33 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎯 ExamVjpPro - AI-Powered Quiz Generator

Next.js TypeScript Convex Tailwind CSS

Transform your PDFs into intelligent quizzes with the power of AI! πŸš€

ExamVjpPro Preview

✨ What Makes ExamVjpPro Special?

ExamVjpPro is your ultimate study companion that turns any PDF document into comprehensive multiple-choice questions using advanced AI technology. Whether you're a student preparing for exams or an educator creating assessments, we've got you covered!

πŸŽ‰ Key Features

  • πŸ€– AI-Powered Question Generation: Upload PDFs and watch as our AI creates thoughtful, relevant questions instantly
  • πŸ“Š Smart Analytics: Track your progress with detailed performance metrics and insights
  • ⚑ Lightning Fast: Generate questions in under 2 minutes on average
  • 🎨 Beautiful UI: Clean, modern interface built with Radix UI and Tailwind CSS
  • πŸ” Secure Authentication: Robust user authentication with Convex Auth
  • πŸ“± Responsive Design: Perfect experience across all devices
  • πŸŒ™ Dark Mode: Easy on the eyes with full dark mode support
  • πŸ“ˆ Progress Tracking: Monitor your learning journey with comprehensive attempt history

πŸ† Impressive Stats

  • 10K+ Questions Generated
  • 95% Accuracy Rate
  • 2min Average Processing Time

πŸš€ Getting Started

Prerequisites

Make sure you have these installed:

  • Node.js 18+
  • pnpm (recommended) or npm
  • A Convex account (free to start!)

Installation

  1. Clone the repository

    git clone https://github.com/napthedev/examvjppro.git
    cd examvjppro
  2. Install dependencies

    pnpm install
  3. Set up Convex

    npx convex dev
  4. Configure authentication

    npx @convex-dev/auth
  5. Start the development server

    pnpm dev
  6. Open your browser Navigate to http://localhost:3000 and start creating amazing quizzes! πŸŽ‰

Environment Setup

Create a .env.local file in your root directory:

# Convex
CONVEX_DEPLOYMENT=your-deployment-url
NEXT_PUBLIC_CONVEX_URL=your-convex-url

# Authentication (configure based on your providers)
AUTH_SECRET=your-auth-secret

πŸ› οΈ Built With Love Using

Core Technologies

UI Components & Styling

AI & Processing

Forms & Validation

πŸ“ Project Structure

examvjppro/
β”œβ”€β”€ app/                    # Next.js App Router
β”‚   β”œβ”€β”€ api/               # API routes
β”‚   β”œβ”€β”€ dashboard/         # Dashboard pages
β”‚   β”œβ”€β”€ exam/             # Exam-related pages
β”‚   └── signin/           # Authentication
β”œβ”€β”€ components/            # React components
β”‚   β”œβ”€β”€ ui/               # Reusable UI components
β”‚   β”œβ”€β”€ landing/          # Landing page components
β”‚   β”œβ”€β”€ dashboard/        # Dashboard components
β”‚   └── exam/             # Exam components
β”œβ”€β”€ convex/               # Convex backend
β”‚   β”œβ”€β”€ schema.ts         # Database schema
β”‚   β”œβ”€β”€ exams.ts          # Exam-related functions
β”‚   └── auth.ts           # Authentication setup
β”œβ”€β”€ hooks/                # Custom React hooks
β”œβ”€β”€ lib/                  # Utility functions
└── public/               # Static assets

🎯 Core Features Deep Dive

PDF Processing & AI Generation

Our AI analyzes your PDF content and generates:

  • Multiple-choice questions with 4 options each
  • Detailed explanations for correct answers
  • Difficulty-appropriate content
  • Well-structured question formats

User Dashboard

  • Upload and manage your PDFs
  • View all generated exams
  • Track your progress and scores
  • Edit exam names and descriptions

Exam Taking Experience

  • Clean, distraction-free interface
  • Timer functionality
  • Instant feedback
  • Comprehensive result analysis

Progress Analytics

  • Detailed attempt history
  • Score tracking over time
  • Performance insights
  • Improvement recommendations

πŸš€ Deployment

Vercel (Recommended)

  1. Deploy to Vercel

    vercel --prod
  2. Set up Convex for production

    npx convex deploy --prod
  3. Configure environment variables in your Vercel dashboard

For detailed deployment instructions, check out our Deployment Guide.

🀝 Contributing

We love contributions! Here's how you can help make ExamVjpPro even better:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Make your changes and add tests if applicable
  4. Commit your changes: git commit -m 'Add amazing feature'
  5. Push to the branch: git push origin feature/amazing-feature
  6. Open a Pull Request

Please read our contributing guidelines and make sure to follow our code of conduct.

πŸ“ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgments

  • Thanks to the amazing open-source community
  • Inspired by the need for better study tools
  • Built with passion for education and learning

🌟 Star History

If you find ExamVjpPro useful, please consider giving it a star! ⭐


About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors