College-Connect-

πŸŽ“ Campus Finder

Project Status License Tech Stack

Campus Finder is a premium, modern web application designed to simplify the college search and admission process. Built with React and tailored with high-end aesthetics, it serves as a comprehensive bridge between students and their future educational institutions.


πŸ“‘ Table of Contents


πŸš€ Project Overview

Campus Finder helps students navigate the complex landscape of higher education. The platform allows users to:

The project emphasizes a user-first approach, combining functional depth with a visually stunning interface.


✨ Key Features

πŸ“ Dynamic Blog System

🎯 Seamless Application Process

πŸ“± Fully Responsive


🎨 UI/UX Highlights

We have prioritized a premium look and feel:


πŸ›  Tech Stack

This project leverages modern web technologies for performance and maintainability:

Category Technology
Frontend Framework React React v18
Styling TailwindCSS Tailwind CSS v3
Routing React Router React Router DOM v6
Build Tool Webpack Webpack v5
State Management React Context API & Hooks
Image Management Cloudinary

⚑ Getting Started

Follow these steps to set up the project locally:

Prerequisites

Installation

  1. Clone the repository
    git clone https://github.com/yourusername/campus-finder.git
    cd campus-finder
    
  2. Install dependencies
    npm install
    # or
    yarn install
    
  3. Environment Setup
    • Create a .env file in the root directory (if not present).
    • Add necessary API keys (e.g., Cloudinary credentials) if applicable.
  4. Run the Development Server
    npm run dev
    # or
    npm start
    

    The app will open at http://localhost:8080 (or similar port).

  5. Build for Production
    npm run build
    

πŸ“‚ Project Structure

A high-level overview of the source code:

src/
β”œβ”€β”€ assets/          # Static assets (images, icons)
β”œβ”€β”€ components/      # Reusable UI components (Cards, Navbar, Footer)
β”œβ”€β”€ context/         # Global state management
β”œβ”€β”€ data/            # Static data files (mock data for blogs/colleges)
β”œβ”€β”€ layouts/         # Page layout wrappers (MainLayout, etc.)
β”œβ”€β”€ pages/           # Application views
β”‚   β”œβ”€β”€ Home/        # Landing page
β”‚   β”œβ”€β”€ Campuses/    # List of colleges
β”‚   β”œβ”€β”€ CollegeDetails/ # Single college view
β”‚   β”œβ”€β”€ Blog/        # Blog feed
β”‚   β”œβ”€β”€ Contact/     # Contact page
β”‚   └── Apply/       # Application form
β”œβ”€β”€ utils/           # Helper functions
β”œβ”€β”€ App.js           # Main app component & routing
└── index.css        # Global styles & Tailwind directives

⚠️ Notes


πŸ‘¨β€πŸ’» Author

Developed with ❀️ by Ayush Nautiyal