Skip to content

pvishalkeerthan/Think_Track

Repository files navigation

ThinkTrack - Personalized Testing by Learning

Welcome to ThinkTrack, your go-to platform for personalized knowledge testing, gamified learning, and real-time performance insights. With ThinkTrack, you're not just taking a test—you’re embarking on a dynamic learning journey that grows with you. Whether you’re brushing up on topics for school, prepping for a certification, or just curious to challenge your knowledge, ThinkTrack has it all!

🚀 Key Features

1. User Authentication

  • Simple and secure login/registration to track individual progress. Access your test history, save preferences, and resume anytime!

2. Customizable Quizzes 🛠️

  • Choose your topic: From programming to history, customize your quiz content.
  • Number of questions: Want a quick test? Set 5 questions. Want a challenge? Go for 50!
  • Difficulty levels: Test yourself on Easy, Medium, or Hard questions.
  • Question types: Select from MCQs, Fill-in-the-Blanks, True/False, and more.
  • Time limits: Set time constraints or go at your own pace.
  • New: Now supports Image-based Questions and Drag-and-Drop answers for interactive learning!

3. Real-Time Assessments

  • Immediate scoring after quiz completion, with detailed breakdowns by topic and difficulty.

4. Collaborative Test-Taking 🤝 (New!)

  • Study in groups! Host or join a collaborative quiz with friends or classmates and challenge each other to level up together.

5. Personalized Feedback & Recommendations

  • Beyond the score: After each test, get personalized feedback with actionable insights on how to improve. Our smart recommendation engine will guide you toward relevant resources, quizzes, and study materials.

6. Progress Tracking 📈

  • Track your performance over time! Get detailed analytics to visualize your growth and set milestones. Whether you're studying for an exam or improving specific skills, see how far you’ve come.

7. Gamification & Badges 🏆 (New!)

  • Earn Badges: Complete quizzes, reach milestones, or get top scores to unlock badges!
  • Activity Monitoring: Monitor your activity and unlock achievements based on your consistency, speed, and performance.
  • Leaderboard: Compete with other learners globally and see how you rank across different subjects!

8. Diverse Test Formats 📝 (New!)

  • In addition to traditional quizzes, try Timed Challenges, Scenario-Based Quizzes, and Simulation Tests for more in-depth assessments.

9. Custom Learning Paths (New!)

  • We know every learner is unique! Create your custom learning path and tailor quizzes to meet your goals. Our AI-powered platform adapts to your needs and suggests personalized study plans.

🛠️ Tech Stack

  • Framework: Next.js for seamless SSR and client-side transitions.
  • Backend API: Gemini API for quiz data and real-time results.
  • Database: MongoDB for robust, scalable data management.
  • Styling: Tailwind CSS for a modern, responsive, and clean UI.
  • State Management: Redux/Context API for smooth handling of global state.

🚀 Getting Started

Prerequisites

Ensure you have the following to run ThinkTrack locally:

  • Node.js v16 or higher
  • npm or yarn package manager
  • MongoDB instance (local or cloud-based)

Installation

  1. Clone the repository:

    git clone https://github.com/pvishalkeerthan/Think-Track.git
    cd Think-Track
  2. Install the dependencies:

    npm install
  3. Set up environment variables by creating a .env.local file and adding:

    GEMINI_API_KEY=your-gemini-api-key
    MONGODB_URI=your-mongodb-uri
    JWT_SECRET=your-secret-key
  4. Run the development server:

    npm run dev
  5. Open http://localhost:3000 in your browser to see the app in action!


🧪 Testing

We take testing seriously! Our platform is equipped with unit tests and end-to-end tests using Jest and Cypress to ensure a bug-free experience.

To run the tests, simply execute:

npm run test

📦 Deployment

Deploy ThinkTrack effortlessly on platforms like Vercel by following these steps:

  1. Push your repository to GitHub.
  2. Sign up or log in to Vercel, and connect your repository.
  3. Configure your environment variables directly within Vercel’s dashboard.
  4. Deploy with just one click!

🎮 Gamified Learning

How to Level Up 🚀

With the new gamification features, you can turn studying into a fun competition! Here's how to make the most of it:

  • Earn Points for every quiz you take, based on accuracy, speed, and consistency.
  • Climb the Leaderboard by challenging your friends or fellow students in collaborative quizzes.
  • Unlock Badges for hitting study streaks, perfect scores, and more!

Stay motivated by visualizing your progress and competing against others in the global leaderboard!


About

ThinkTrack is an adaptive quiz platform offering personalized tests, real-time feedback, and progress tracking, with gamified and collaborative learning features.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors