Skip to content

samuel-ma/sslearn

Repository files navigation

QuizMaster App

image

Overview

QuizMaster App is a modern, interactive educational platform to track quiz progress, review past performances, and engage with a dynamic leaderboard. The application boasts a beautiful UI with smooth animations and real-time insights for a delightful learning experience.

Features

  • Quiz Management: Explore and attempt quizzes with instant feedback.
  • Analytics Dashboard: Interactive charts to visualize student performance.
  • Quiz History: Detailed records of past quiz attempts with performance metrics.
  • Leaderboards: Global and personal rankings to compete with peers.
  • Learning Modules: Rich subject content and course ratings to guide your study.
  • Achievements System: Earn badges, milestones, and unlock rewards as you progress.
  • Responsive UI & Animations: Enjoy smooth interactions and skeleton loaders while content loads.

Technology Stack

  • React & Next.js: For building dynamic user interfaces.
  • Framer Motion: For fluid animations and transitions.
  • Recharts: For vibrant data visualization.
  • Tailwind CSS: For rapid, responsive styling.
  • Lucide Icons: For crisp, customizable icons.

Installation & Setup

  1. Clone the repository:
    git clone https://github.com/yourusername/quizmaster.git
  2. Install dependencies:
    cd quizmaster
    npm install
  3. Run the development server:
    npm run dev
  4. Open http://localhost:3000 in your browser.

Project Structure

  • /app/analytics/: Analytics dashboard with interactive charts and loading skeletons.
  • /app/quiz-history/: History page displaying past quizzes with detailed stats.
  • /app/quizzes/: Quiz overview and navigation features with loading states.
  • /app/leaderboard/: Global and personal rankings with filtering and search.
  • /app/learn/: Learning progress, subjects, and recommended courses.
  • /components/ui/: Reusable UI components including cards, buttons, and skeleton loaders.

User Experience

  • Interactive Animations: Smooth page transitions and hover effects enhance navigation.
  • Skeleton Loading States: Intuitive placeholders display while data is fetched.
  • Visual Data Insights: Charts and graphs clearly depict progress and performance trends.
  • Engaging Rewards: An achievement system that motivates with badges and rewards.

Future Enhancements

  • Integration with real-time data and personalized content.
  • Enhanced filtering and advanced analytics.
  • Additional accessibility improvements.
  • Expansion of the learning modules and achievement rewards.

License

This project is licensed under the MIT License.

Contributing

Contributions are welcome! Please submit a pull request with your enhancements or create an issue detailing any suggestions or bugs.


Happy Learning with QuizMaster!

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages