🧠 ExamGenie AI

The Ultimate AI-Powered Assessment Platform for Smart Learning

🚀 Live Demo • 📖 Documentation • 🤝 Contributing • 📄 License

✨ Overview

ExamGenie AI is a cutting-edge, AI-powered assessment platform that revolutionizes how students and professionals prepare for competitive exams. With advanced GPT models generating contextual questions, instant feedback, and comprehensive analytics, it's the ultimate tool for smart learning and exam preparation.

🎯 Key Highlights

🤖 AI-Generated Questions: Advanced GPT models create unique, contextual questions
⚡ Instant Results: Get immediate scoring and detailed explanations
📊 Advanced Analytics: Track progress with detailed performance insights
🔒 Secure & Reliable: Enterprise-grade security for your data
📱 Mobile Optimized: Seamless experience across all devices
🎮 Gamified Learning: Achievement badges and progress rewards

🚀 Features

🧠 AI-Powered Question Generation

Advanced GPT models create unique, contextual questions tailored to your learning needs
95% accuracy rate with 2M+ questions generated
Adaptive difficulty based on performance patterns

⚡ Instant Results & Feedback

Immediate scoring and detailed explanations for every answer
Real-time performance tracking
Adaptive time management algorithms

📊 Advanced Analytics

Detailed performance insights and topic-wise breakdowns
Progress tracking with visual charts
Export and share results with educators or employers

🎮 Gamified Learning Experience

Achievement badges and leaderboards
Progress rewards to keep you motivated
Collaborative platform for study groups

🔒 Enterprise-Grade Security

Secure data handling and test results protection
Multi-user management for institutions
Custom branding and white-label solutions

🏗️ Tech Stack

Frontend

React 18.3.1 - Modern UI library
TypeScript 5.5.3 - Type-safe development
Vite 7.1.4 - Lightning-fast build tool
Tailwind CSS 3.4.11 - Utility-first styling
shadcn/ui - Beautiful, accessible components

State Management & Routing

React Router DOM 6.26.2 - Client-side routing
TanStack Query 5.56.2 - Server state management
React Hook Form 7.53.0 - Form handling

UI Components

Radix UI - Headless UI primitives
Lucide React - Beautiful icons
Sonner - Toast notifications
Recharts - Data visualization

Authentication

Google OAuth - Social authentication
React OAuth Google - OAuth integration

📱 Supported Exam Categories

Our platform covers 50+ exam categories including:

🏛️ Civil Services - UPSC, State PSCs
🔬 Engineering Entrance - JEE Main, JEE Advanced, BITSAT
🏥 Medical Entrance - NEET, AIIMS, JIPMER
🎓 Management Entrance - CAT, XAT, SNAP, MAT
⚖️ Law Entrance - CLAT, AILET, LSAT
🏦 Banking & Finance - IBPS, SBI PO, RBI Grade B
🛡️ Defense Services - NDA, CDS, AFCAT
👨‍🏫 Teaching Eligibility - CTET, UGC NET
🚂 Railways - RRB NTPC, RRB JE
🏆 Scholarship & Olympiads - NTSE, KVPY, SOF

And many more...

🚀 Quick Start

Prerequisites

Node.js 18.0 or later
npm 9.0 or later
Git for version control

Installation

Clone the repository

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

Install dependencies
```
npm install
```
Start development server
```
npm run dev
```
Open your browser Navigate to http://localhost:8080

Available Scripts

# Development
npm run dev          # Start dev server on port 8080
npm run dev:8081     # Start dev server on port 8081

# Building
npm run build        # Build for production
npm run build:dev    # Build in development mode

# Linting
npm run lint         # Run ESLint

# Preview
npm run preview      # Preview production build

🌐 Deployment

Netlify (Recommended)

Connect your repository to Netlify
Configure build settings:
- Build command: npm run build
- Publish directory: dist
- Node version: 18
Deploy - Netlify will automatically build and deploy

Manual Deployment

# Build the project
npm run build

# Deploy the dist folder to your hosting provider

For detailed deployment instructions, see NETLIFY_DEPLOYMENT.md.

📁 Project Structure

examgenie-ai/
├── public/                 # Static assets
│   ├── _redirects         # Netlify SPA routing
│   └── favicon.ico
├── src/
│   ├── components/        # Reusable components
│   │   ├── ui/           # shadcn/ui components
│   │   ├── Home.tsx      # Landing page hero
│   │   ├── Features.tsx  # Features section
│   │   └── ...
│   ├── pages/            # Page components
│   │   ├── Index.tsx     # Home page
│   │   ├── Dashboard.tsx # User dashboard
│   │   ├── TestInterface.tsx # Exam interface
│   │   └── ...
│   ├── data/             # Static data
│   │   ├── categories.ts # Exam categories
│   │   ├── examsInfo.ts  # Exam information
│   │   └── ...
│   ├── hooks/            # Custom React hooks
│   ├── lib/              # Utility functions
│   └── utils/            # API utilities
├── netlify.toml          # Netlify configuration
├── vite.config.ts        # Vite configuration
└── package.json

🎨 UI Components

Built with shadcn/ui and Radix UI for accessibility and customization:

Cards - Information display
Buttons - Interactive elements
Forms - Input handling
Charts - Data visualization
Modals - Overlay dialogs
Navigation - Menu systems
Tables - Data presentation

🔧 Configuration

Environment Variables

Create a .env.local file:

# Google OAuth
VITE_GOOGLE_CLIENT_ID=your_google_client_id

# API Configuration
VITE_API_BASE_URL=your_api_base_url

# Feature Flags
VITE_ENABLE_ANALYTICS=true
VITE_ENABLE_DARK_MODE=true

Vite Configuration

The project uses Vite with optimized settings for production:

// vite.config.ts
export default defineConfig({
  base: "/",
  plugins: [react()],
  resolve: {
    alias: {
      "@": path.resolve(__dirname, "./src"),
    },
  },
});

📊 Performance

⚡ Lightning Fast: Vite-powered development and building
📱 Mobile First: Responsive design for all devices
🎯 Optimized Bundle: Code splitting and lazy loading
🔄 Hot Reload: Instant development feedback

Bundle Analysis

# Analyze bundle size
npm run build
# Check dist folder for optimized assets

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Workflow

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Code Style

ESLint for code linting
Prettier for code formatting
TypeScript for type safety
Conventional Commits for commit messages

📄 License

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

🙏 Acknowledgments

shadcn/ui for beautiful, accessible components
Radix UI for headless UI primitives
Vite for the amazing build tool
React team for the incredible framework
Tailwind CSS for utility-first styling

📞 Support

📧 Email: support@examgenie.ai
💬 Discord: Join our community
📖 Documentation: docs.examgenie.ai
🐛 Issues: GitHub Issues

Made with ❤️ by the ExamGenie AI Team

⭐ Star this repo • 🐦 Follow us on Twitter • 📺 Subscribe on YouTube

Name		Name	Last commit message	Last commit date
Latest commit History 133 Commits
public		public
src		src
.env		.env
.gitignore		.gitignore
README.md		README.md
bun.lockb		bun.lockb
components.json		components.json
eslint.config.js		eslint.config.js
index.html		index.html
netlify.toml		netlify.toml
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
tailwind.config.ts		tailwind.config.ts
tsconfig.app.json		tsconfig.app.json
tsconfig.json		tsconfig.json
tsconfig.node.json		tsconfig.node.json
vite.config.ts		vite.config.ts

Vasu10134/Examgenie-ai

Folders and files

Latest commit

History

Repository files navigation