Shadowwfall/School_Website

EduStream is a modern school portal that brings students, teachers, and parents together. It features a real-time notice board, easy resource sharing, and a helpful AI assistant for student questions. Designed for simplicity, EduStream helps our entire school community stay connected, organized, and supported every single day.

โ˜… 0Forks 0JavaScriptGitHub โ†—Compare

README

๐ŸŽ“ EduStream Academy Portal

EduStream is a comprehensive Full-Stack Academic Management Portal designed to bridge the gap between students, faculty, and administration.Built with the MERN stack (MongoDB, Express, React, Node.js), it features real-time notice boards, academic resource sharing, and an AI-integrated support system for student inquiries.


๐Ÿš€ Features

๐Ÿ“ข Real-Time Notice Board

  • Dynamic announcements fetched from the MongoDB database.
  • Instant updates for students and faculty.

๐Ÿ“š Academic Resource Hub

  • Centralized repository for course materials and STEM excellence programs.
  • Easy access to academic resources.

๐Ÿค– AI Support Integration

  • Powered by the Gemini API.
  • Handles admission and academic queries instantly.

๐Ÿซ Infinite Campus Gallery

  • High-performance CSS-animated marquee.
  • Showcases campus life and activities.

๐ŸŽจ Professional UI

  • Fully responsive design.
  • Built with Tailwind CSS and Lucide React Icons.

๐Ÿ› ๏ธ Tech Stack

Frontend

  • React.js
  • Vite
  • Tailwind CSS
  • Axios

Backend

  • Node.js
  • Express.js

Database

  • MongoDB

AI Integration

  • Gemini API

๐Ÿ“‚ Project Structure

SCHOOL_WEBSITE/
โ”‚
โ”œโ”€โ”€ backend/                 # Node.js & Express Server
โ”‚   โ”œโ”€โ”€ config/              # MongoDB Connection Logic
โ”‚   โ”œโ”€โ”€ controllers/         # Business Logic
โ”‚   โ”œโ”€โ”€ routes/              # API Endpoints
โ”‚   โ””โ”€โ”€ server.js            # Entry Point
โ”‚
โ”œโ”€โ”€ frontend/                # React & Vite Application
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”‚   โ”œโ”€โ”€ api/             # Axios Configurations
โ”‚   โ”‚   โ”œโ”€โ”€ components/      # Reusable UI Components
โ”‚   โ”‚   โ””โ”€โ”€ data/            # Static Data & State Management
โ”‚
โ””โ”€โ”€ .env                     # Environment Variables

โš™๏ธ Setup & Installation

Prerequisites

Make sure you have the following installed:

  • Node.js (v18+)
  • MongoDB
  • npm (Node Package Manager)

1๏ธโƒฃ Clone the Repository

git clone https://github.com/Sitaram8472/School_Website.git
cd School_Website

2๏ธโƒฃ Backend Setup

Navigate to the backend folder:

cd backend

Install dependencies:

npm install

Create a .env file inside the backend directory and add the required environment variables:

MONGODB_URI=your_mongodb_connection_string
PORT=5000
GEMINI_API_KEY=your_gemini_api_key

Start the backend server:

npm run dev

3๏ธโƒฃ Frontend Setup

Navigate to the frontend folder:

cd ../frontend

Install dependencies:

npm install

Start the React application:

npm run dev

๐Ÿค Contribution Guide

We welcome contributions from the community!

Steps to Contribute

  1. Fork the repository.
  2. Create a feature branch:
git checkout -b feature/AmazingFeature
  1. Commit your changes:
git commit -m "Add AmazingFeature"
  1. Push to your branch:
git push origin feature/AmazingFeature
  1. Open a Pull Request.

๐ŸŒŸ Support

If you find this project useful, don't forget to give it a โญ on GitHub.

Happy Coding! ๐Ÿš€

Contributors

Sitaram8472deepali-kumari-iitpShalini828zaibamachhaliyaeshikarupani2519Sargam-GhagreUtkrisht-Utpaljikrana1SilverMenaceRudra-clrscrSiddharthRiotvarshitaneyyilavineelatallams143-bitvineelatallam2008-star

Issues