Skip to content

Poonam146/college-nexus

 
 

Repository files navigation

College Nexus: College Review & Counseling Platform

Welcome to College Nexus, an open-source web app designed to help students find their ideal college based on reviews, counseling, and a JEE Main college predictor. This app was initially developed using HTML, CSS, and JavaScript, and now it's migrating to Next.js to provide more robust functionality, better performance, and easier contributions!

🌟 Features

  • College Predictor - Uses ranks and domicile status to suggest eligible colleges.
  • Responsive Design - Works seamlessly across devices.
  • Comprehensive College Details - Information on IITs, NITs, IIITs, and other prominent engineering institutions in India.
  • User-Friendly Interface - Smooth navigation and an intuitive interface.
  • Contact Us Form - Allows students to reach out for personalized counseling.

🛠️ Tech Stack

  • Frontend: HTML, CSS, JavaScript (Legacy), Next.js (New Migration)
  • Styling: Custom CSS, Font Awesome
  • Hosting: Render (Currently)
  • API: Google Forms (for Contact Form submissions)

🚀 Getting Started

Prerequisites

  • Node.js
  • npm or yarn

Installation

  1. Clone the Repository

    git clone https://github.com/yourusername/college-nexus.git
    cd college-nexus
  2. Install Dependencies

    npm install
  3. Run the Development Server

    npm run dev

    Open http://localhost:3000 to view it in the browser.

Build for Production

To create an optimized build for production, run:

npm run build

Then, start the server:

npm start

📑 Contribution Guidelines

We're participating in Hacktoberfest 2024, and we welcome contributions from the community! Here's how you can contribute:

  1. Fork the Repository on GitHub.
  2. Create a New Branch for your feature or bug fix.
    git checkout -b feature/your-feature-name
  3. Commit your Changes with clear messages.
git commit -m "Add new feature: your feature name"
  1. Push to your Fork and submit a Pull Request.
git push origin feature/your-feature-name

All contributions are welcome, from fixing a small typo to creating new features or enhancing the UI/UX!

##📧 Contact For questions or suggestions, feel free to reach out or submit an issue. You can also connect with the project maintainer on LinkedIn or Instagram.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • HTML 69.1%
  • CSS 18.0%
  • JavaScript 12.9%