🎓 rank2college

Intelligent College Recommendation System for JEE Aspirants

A modern web application that helps JEE (Joint Entrance Examination) aspirants find eligible colleges based on their rank, seat type, gender, and other preferences. Built with Next.js and powered by official JoSAA data.

✨ Features

• 🎯 Smart College Matching: Find eligible colleges based on your JEE rank
• 🏛️ Comprehensive Filters: Filter by seat type, college type, domicile, and gender
• 📊 Real-time Results: Instant college recommendations with detailed information
• 🏠 Home State Quota: Special handling for home state quota colleges
• 📱 Responsive Design: Works seamlessly on desktop, tablet, and mobile
• 🎨 Modern UI/UX: Beautiful interface built with NextUI and Tailwind CSS
• 📈 Data Accuracy: Based on official JoSAA data updated till 2024 Round 5

🚀 Live Demo

Visit the application: rank2college

🛠️ Tech Stack

Frontend

• Next.js 14 - React framework with App Router
• React 18 - UI library
• Tailwind CSS - Utility-first CSS framework
• NextUI - Modern React UI components
• Lucide React - Beautiful icons

Backend

• Next.js API Routes - Serverless API endpoints
• CSV Parser - Data processing from CSV files
• CORS - Cross-origin resource sharing

Data

• CSV Data Source - Official JoSAA college data
• MongoDB - Database (configured for future use)

📋 Prerequisites

Before you begin, ensure you have the following installed:

• Node.js (version 18.0.0 or higher)
• npm or yarn package manager
• Git for version control

🚀 Quick Start

1. Clone the Repository

git clone https://github.com/yourusername/rank2college.git
cd rank2college

2. Install Dependencies

npm install
# or
yarn install

3. Set Up Environment Variables

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

# Database (optional for now)
MONGODB_URI=your_mongodb_connection_string

# API Configuration
NEXT_PUBLIC_API_URL=http://localhost:3000

4. Run the Development Server

npm run dev
# or
yarn dev

Open http://localhost:3000 in your browser to see the application.

5. Build for Production

npm run build
npm start

📁 Project Structure

rank2college/
├── public/
│   ├── assets/          # Static assets (images, icons)
│   └── orcrdata.csv     # College data source
├── src/
│   ├── app/             # Next.js App Router
│   │   ├── api/         # API routes
│   │   ├── globals.css  # Global styles
│   │   ├── layout.js    # Root layout
│   │   └── page.js      # Home page
│   └── components/      # Reusable React components
│       ├── Faqs.js      # FAQ section
│       ├── Footer.js    # Footer component
│       ├── HeroSection.js # Hero section
│       └── Navbar.js    # Navigation bar
├── package.json         # Dependencies and scripts
├── tailwind.config.js   # Tailwind CSS configuration
└── next.config.mjs      # Next.js configuration

🔧 Configuration

Tailwind CSS

The project uses Tailwind CSS for styling. Configuration can be found in tailwind.config.js.

Next.js

Next.js configuration is in next.config.mjs. The project uses the App Router and includes optimizations for performance.

📊 Data Source

The application uses official JoSAA (Joint Seat Allocation Authority) data stored in public/orcrdata.csv. This data includes:

• College names and types
• Seat types and quotas
• Opening and closing ranks
• Gender specifications
• State information

🤝 Contributing

We welcome contributions from the community! Here's how you can help:

🐛 Reporting Bugs

• Use the GitHub Issues page
• Provide detailed bug reports with steps to reproduce
• Include browser/device information

💡 Suggesting Features

• Open a new issue with the "enhancement" label
• Describe the feature and its benefits
• Discuss implementation approaches

🔧 Code Contributions

1. Fork the repository
2. Create a feature branch

   git checkout -b feature/amazing-feature

3. Make your changes
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

📝 Development Guidelines

• Follow the existing code style and conventions
• Write meaningful commit messages
• Test your changes thoroughly
• Update documentation if needed
• Ensure responsive design works on all devices

🧪 Testing

# Run linting
npm run lint

# Run tests (when implemented)
npm test

# Build check
npm run build

🎯 Roadmap

• User Authentication - Login/signup system
• College Reviews - Student feedback and ratings
• Advanced Filters - More sophisticated search options
• Mobile App - React Native version
• Data Analytics - College admission trends
• Notifications - Updates on college admissions
• Export Options - PDF/Excel export of results

📱 Browser Support

• Chrome (latest)
• Firefox (latest)
• Safari (latest)
• Edge (latest)

📄 License

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

🙏 Acknowledgments

• JoSAA for providing official college admission data
• Next.js team for the amazing framework
• Tailwind CSS for the utility-first CSS approach
• NextUI for beautiful React components
• Open source community for inspiration and support

⭐ Star the Project

If you find this project helpful, please give it a ⭐ star on GitHub!

---

Helping students make informed decisions about their future education