EduHaven

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 76 Open GitHub ↗

EduHaven: A Student-Centric Learning Platform

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![join our group on discord](https://raw.githubusercontent.com/EduHaven/EduHaven/main/Client/public/joinDiscordIcon.png)
](https://discord.gg/uZv6ShY345)

# Eduhaven

![image](https://github.com/user-attachments/assets/970c84bf-ac78-4583-af73-d2b8b4b393b0)

**EduHaven** is a platform designed to assist students by providing a productivity-focused environment. It aims to provide a space where students can Learn and grow together by socialising with friends. It incorporates real-time collaboration, task management, analytics, AI-chatbot, note-making, gamification and more.

### Features :

- **_User Dashboard (Home Page)_**

> Study and break timer, stats summary, notes management, goal setting with deadlines, integrated calendar, and study tools like AI chat, calculator, converter, and graph.

- **_Real-Time Study Rooms_**

> Create or join study rooms with friends, use video/audio controls, manage permissions, and chat for discussions.

- **_Realtime Stats_**

> Track study time, streaks, global and friend ranks, badges, goal completion, and friends' analytics.

- **_Realtime Chat_**

> Chat with peers, share notes and study materials, send private messages, and see online/offline presence.

- **_Friends and Social Features_**

> Add friends, invite them to rooms, track their status, and share goals and progress.

- **_Gamification_**
  > Earn badges and rewards, maintain streaks, climb leaderboards, and play games to refresh your mind.

## Tech Stack

- **Frontend**: React.js, Tailwind, Zustand, Tansack-query
- **Backend**: Node.js with Express
- **Database**: MongoDB, Cloudinary
- **Real-Time Communication**: Socket.IO, WebRTC

## Folder Structure

```
📦EduHaven/
├─ 📂.github/                   # 🔧 GitHub workflows, issue & PR templates
│
├─ 📂 client/                   # Frontend (React + Vite) =============================
│  ├─ 📂 src/                   # Main frontend source code
│  │  ├─ 📂 api/                # API call functions (fetch, axios, etc.)
│  │  ├─ 📂 assets/             # Images, fonts, icons (bundled in app)
│  │  ├─ 📂 Auth/               # Authentication pages (login, signup, OTP, password, etc)
│  │  ├─ 📂 components/         # Reusable UI components (buttons, popups, dropdowns etc.)
│  │  ├─ 📂 contexts/           # React Context providers (global state)
│  │  ├─ 📂 hooks/              # Custom React hooks (useAuth, useFetch, etc.)
│  │  ├─ 📂 lib/
│  │  ├─ 📂 pages/              # Route-level pages (Home, stats, chat, notes, etc )
│  │  ├─ 📂 queries/            # Data fetching/mutations (Tanstack Query, etc.)
│  │  ├─ 📂 routes/             # Route definitions (React Router setup)
│  │  ├─ 📂 stores/             # State management (Zustand)
│  │  ├─ 📂 utils/              # Helper utilities (axios, error handlers, etc.)
│  │  ├─ 📄 App.jsx             # Root React component
│  │  ├─ 📄 index.css           # Global styles
│  │  └─ 📄 main.jsx            # Entry point of app
│  │
│  ├─ 📂 public/                # Static assets (served directly)
│  │  ├─ 📂 EduhavenBadges/     # Badge images
│  │  ├─ 📂 sounds/             # Audio files
│  │  └─ 📄 .......             # Other media files
│  │
│  ├─ 📄 .env.example           # Example frontend env variables
│  ├─ 📄 .env.extension         # Browser extension config
│  ├─ 📄 vite.config.js
│  ├─ 📄 tailwind.config.js
│  └─ 📄 package.json           # Frontend dependencies & scripts
│
├─ 📂 server/                   # Backend (Node.js + Express) ===========================
│  ├─ 📂 Controller/            # Request handlers
│  ├─ 📂 Routes/                # API routes
│  ├─ 📂 Model/                 # Database models/schemas
│  ├─ 📂 Database/              # Database connection/setup
│  ├─ 📂 Middlewares/           # Express middlewares
│  ├─ 📂 Socket/                # WebSocket functionality
│  ├─ 📂 security/              # Security configurations
│  ├─ 📂 utils/                 # Helper functions
│  ├─ 📄 .env.example           # Example backend env variables
│  ├─ 📄 index.js               # Backend entry point
│  └─ 📄 API_DOCS.md            # You can view list of all endpoints here
│
├─ 📄 CONTRIBUTING.md           # Contribution guidelines
├─ 📄 CODE_OF_CONDUCT.md        # Code of conduct
├─ 📄 .prettierrc.json          # Code formatting rules
└─ 📄 LEARN.md                  # Reference / learning notes
```

## Installation and Setup

- Make sure you've joined our [discord server](https://discord.gg/uZv6ShY345) so you can connect in case you face any issues.
- **Prerequisites:** Node.js, MongoDB, Git

### Steps to Run Locally

1. After forking the repository, Clone the forked repository:

```bash
   git clone https://github.com/<your-username>/EduHaven.git
   cd EduHaven

```

2. Install dependencies:

```bash
   # Install backend dependencies
   cd Server
   npm install

# Install frontend dependencies
   cd ../Client
   npm install
   ```

3. Set up environment variables:

- **for frontend:**

- create a `.env` file in the `/Client` directory, and copy all the contents from `.env.example`.

- **for backend:**

- Create a `.env` file in the `/Server` directory.
     - Follow the instructions provided in `.env.example` file to create a new `.env` file for backend.

🔴 **make sure the contents of `.env.example` file must remain untouched.**

4. Start the development servers:

```bash
   # Start backend server
   cd Server
   npm run dev

# Start frontend server
   cd ../Client
   npm run dev
   ```

## Troubleshooting

**MongoDB not connecting** — `MongoNetworkError`. Use local service or Atlas; example connect:
```js
// Server/Database/Db.js
const mongoose = require('mongoose');
const uri = process.env.MONGO_URI || 'mongodb://localhost:27017/eduhaven';
mongoose.connect(uri, { useNewUrlParser:true, useUnifiedTopology:true })
  .then(()=>console.log('MongoDB connected'))
  .catch(err=>{ console.error('MongoDB error:', err.message); process.exit(1); });
```

**CORS blocked** — "blocked by CORS policy". Enable CORS and set client origin:
```js
// Server/index.js (before routes)
const cors = require('cors');
app.use(cors({ origin: process.env.CLIENT_URL || '*', credentials: true }));
```

**OAuth / infinite loading** — spinner never returns. Clear browser storage for localhost and verify `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET` and exact redirect URI in .env and provider console.

## Contribution Guidelines

1. You must get assigned to the issue before you start working on it. leave comment to get issue assigned.
2. Code must be properly formatted. (use preetier configuration provided)
3. Commits should generally be minimal
4. The body of the commit message should explain why and how the change was made.It should provide clear context for all changes mage that will help both a reviewer now, and a developer looking at your changes a year later, understand the motivation behind your decisions.

We welcome contributions to make **EduHaven** better for students everywhere! Here’s how you can contribute:

1. Fork the repository.
2. Create a new branch for your feature/bugfix:
   ```bash
   git checkout -b feature-name
   ```
3. Make your changes and test them thoroughly.

- For frontend changes, also run:
  ```bash
  npm run build
  ```
  and verify there are no build errors.

4. Commit and push your changes:
   ```bash
   git add .
   git commit -m "Add a brief description of your changes"
   git push origin feature-name
   ```
5. Before pushing frontend changes, **run** `npm run build` locally to ensure the project builds successfully. Catch & solve any potential deployment issues early, if any.
6. Create a Pull Request (PR) with a detailed explanation of your changes.

## License

This project is licensed under the MIT License - see the [LICENSE](./License.md) file for details.

## Acknowledgments

- Special thanks to contributors for their efforts in building **EduHaven**.
- Inspired by productivity tools and online collaborative platforms.

## Backend info
- Backend URL: https://eduhaven-backend.onrender.com/

To prevent backend going sleep after short inactivity, we're keeping it alive using [cron-job.org](https://cron-job.org/) to ping the backend every 1 minute.
For full details, see [`KEEP_ALIVE.md`](KEEP_ALIVE.md).

---
For any further queries, feel free to reach out on [Eduhaven's Discord server](https://discord.gg/uZv6ShY345). Let’s make learning fun and productive!

EduHaven

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README