20% Effort, 80% Results

View Demo . Report Bug . Request Feature

• Table Of Contents
• About The Project
• Why EZCrack?
• Features
• Built With
• Getting Started
  • Prerequisites
  • Installation
  • Local Development
  • Environment Variables
• Contributing
  • Creating A Pull Request
• Raising An Issue
• License
• Screenshots
  • Home Page
  • Contributors Page
  • Branch and Semester Page
  • Subject Page
  • Repeated Questions
  • Unit Page
  • Formula Sheet
• Authors

EZCrack is a one-stop platform for IPU students to get instant access to:

• Weightage-wise topic breakdown
• Most repeated questions (concept-based and pattern-based)
• Accurate, curriculum-aligned notes
• Crisp formula sheets
• Topic-wise & year-wise PYQs

When I joined MAIT, I realized that IPU exams mainly consist of repeated PYQs, but there was no way of knowing which PYQs are repeated, which topics are asked frequently, and which topics can be skipped.

There was only one way: a one-stop platform with smart analysis of all PYQs. And that's exactly what EZCrack does. EZCrack analyzes PYQs and tells you the bare minimum you need to study to score the maximum marks.

Not just this, it provides formula sheets and topic-wise notes so that users can study topics selectively. Hence the tagline: 20% Effort, 80% Results.

✨ Smart Organization

• Branch-wise and semester-wise categorization
• Subject and unit-based navigation
• Topic-wise question filtering

📊 Advanced Analytics

• Weightage calculation for each topic
• Question frequency analysis
• Year-wise question distribution
• Repeated question patterns (concept & pattern-based)

📝 Rich Content

• Previous year question papers with answers
• Formula sheets for quick revision
• Topic-wise notes
• Markdown support with KaTeX for mathematical equations

🎯 User-Friendly Features

• Dark/Light theme toggle
• Responsive design for all devices
• Advanced filtering (by year, exam type)
• Multiple view modes (yearwise, repeated questions)
• Search and sort functionality

🤝 Community Driven

• Contributor system for content management
• Open-source and collaborative

EZCrack is built using modern web technologies:

• Next.js 15 - React framework for production
• TypeScript - Type-safe JavaScript
• TailwindCSS - Utility-first CSS framework
• MongoDB - NoSQL database
• Framer Motion - Animation library
• Mongoose - MongoDB object modeling
• React Markdown - Markdown rendering
• KaTeX - Mathematical equation rendering
• Lucide React - Beautiful icon library

Git - A distributed version control system for tracking changes in source code during software development.

Node.js - JavaScript runtime built on Chrome's V8 JavaScript engine. (v18 or higher recommended)

npm - Node package manager (comes with Node.js)

1. Clone the repository

git clone https://github.com/swymbnsl/EZCrack.git

2. Navigate to the project directory

cd EZCrack

3. Install dependencies

npm install

4. Set up environment variables

Create a .env file in the root directory and add the following variables:

MONGODB_URI=your_mongodb_connection_string

5. Run the development server

npm run dev

Server will start at http://localhost:3000/

6. Build for production

npm run build
npm start

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

• If you have suggestions for adding or removing features, feel free to open an issue to discuss it
• Please make sure you check your spelling and grammar
• Create individual PR for each suggestion

Want to contribute to EZCrack?

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

If you're experiencing any problems with EZCrack, please be sure to review our issue template before opening a new issue. The template includes a list of questions and prompts that will help us better understand the issue you're experiencing.

We kindly ask that you provide as much detail as possible when submitting an issue, including:

• Steps to reproduce the problem
• Expected behavior
• Actual behavior
• Screenshots (if applicable)
• Browser and OS information
• Any error messages you've encountered

This will help us identify and fix the issue more quickly.

Thank you for your cooperation, and we look forward to hearing from you!

Distributed under the GNU GPL-3.0 License. See LICENSE for more information.

Browse through different branches and semesters

View all the amazing people who contributed to EZCrack by providing study material

Explore all different subjects available for a specific semester of a branch

Explore all different units available in a subject, year-wise and most repeated PYQs

Explore the most repeated concepts and patterns in PYQs for a subject, along with their frequencies

Explore all different topics, their weightage, notes, formula sheets, and questions in a unit

View all formulas for a unit with proper descriptions

• Swayam Bansal - swymbnsl - Lead Developer

Made with ❤️ for students

⭐ Star us on GitHub!