Skip to content

rkbyoo/JEC-space

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 

Repository files navigation

JEC-SPACE

JEC-SPACE is a mini project for the 6th semester at Jorhat Engineering College. It is a common college space where resources can be shared efficiently among users. The platform allows students to connect, share, and access resources, making campus life more collaborative and convenient.


🌐 Live Demo

Access the deployed app here:
https://jec-space.vercel.app/


🌟 Features

  • User Authentication: Secure signup, login, and OTP verification.
  • Resource Sharing: Users can post, browse, and interact with resources.
  • Contact & Support: Contact form for queries and complaints.
  • Admin Panel: Manage users, products, and contact responses.
  • Responsive UI: Modern, mobile-friendly interface using Ant Design.
  • Integrated Chatbot: Get instant help and resolve doubts about the UI or platform features with the built-in chatbot for a better user experience.

🛠️ Getting Started

Prerequisites

Installation

  1. Clone the repository:

    git clone https://github.com/rkbyoo/JEC-space.git
    cd JEC-space
  2. Install dependencies:

    • Backend:
      cd server
      npm i
    • Frontend:
      cd ../client
      npm i
  3. Environment Variables:

    Create a .env file in the server directory with the following:

    MAIL_USER=your_email@gmail.com
    MAIL_PASS=your_mail_api_password
    DATABASE_URL=your_mongodb_connection_string 
    JWT_SECRET=your_jwt_secret
    PORT=5000
    CLOUD_NAME=your_cloudinary_cloud_name
    API_KEY=your_cloudinary_api_key
    API_SECRET=your_cloudinary_api_secret
    FOLDER_NAME=folder_name
    CLIENT_ORIGIN=https://your_client_url
    

    Create a .env file in the client directory with the following:

    VITE_API_URL=https://backend_deployed_url/api
    
  4. Run the application:

    • Backend:
      cd server
      npm run dev
    • Frontend:
      cd ../client
      npm run dev
  5. Access the app:
    Open http://localhost:5173 in your browser, or use the deployed version.


💬 Chatbot Support

JEC-SPACE features an integrated chatbot to assist users with any doubts or questions regarding the UI and platform usage. Click the chat button at the bottom right of the app to get instant help and enhance your experience.


📁 Project Structure

client/
  ├── src/
  │   ├── pages/
  │   ├── components/
  │   ├── apicalls/
  │   ├── redux/
  │   ├── assets/
  │   └── App.jsx
server/
  ├── config/
  ├── controllers/
  ├── mail/
  ├── middleware/
  ├── models/
  ├── routes/
  ├── uploads/
  ├── utils/
  └── ...

📱 Future Work

  • Mobile App:
    Plans to develop a native app using React Native for seamless mobile access.

    • Native:
      cd ../native

📄 License

This project is for educational purposes as part of the 6th semester mini project at Jorhat Engineering College.


JEC-SPACE — A common space for JECians to connect and share resources!

About

A common space for Jecians to connect and share resources

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •