https://github.com/sagargupta16/lingua-connect
Lingua Connect is an interactive online platform built on the MERN stack, connecting language learners with personalized tutors for tailored online lessons. It facilitates user registration, tutor search, scheduling, and features one-to-one video calls, flashcard storage, and a subscription-based payment model.
https://github.com/sagargupta16/lingua-connect
hackathon mern-stack
Last synced: about 2 months ago
JSON representation
Lingua Connect is an interactive online platform built on the MERN stack, connecting language learners with personalized tutors for tailored online lessons. It facilitates user registration, tutor search, scheduling, and features one-to-one video calls, flashcard storage, and a subscription-based payment model.
- Host: GitHub
- URL: https://github.com/sagargupta16/lingua-connect
- Owner: Sagargupta16
- License: gpl-3.0
- Created: 2024-03-08T14:47:08.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-05-01T19:04:30.000Z (about 2 months ago)
- Last Synced: 2026-05-01T21:09:13.885Z (about 2 months ago)
- Topics: hackathon, mern-stack
- Language: JavaScript
- Homepage:
- Size: 2.98 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# 🌍 Lingua Connect
### *Bridging Languages, Connecting Cultures*
[](https://trinit-bugbiters-dev.onrender.com)
[](LICENSE)
[](https://nodejs.org/)
[](https://reactjs.org/)
[](https://mongodb.com/)
---
## 📖 Overview
**Lingua Connect** is an innovative interactive online platform that seamlessly connects language learners with experienced tutors for personalized, one-on-one language lessons. Our platform empowers students to find the perfect tutor based on their target language, fluency level, budget, and schedule preferences.
### 🎥 Demo Video
[Watch our comprehensive demo video](https://drive.google.com/drive/folders/1FuOogrCMMBdZ2EjXkQJGT1aNbxW4NviK?usp=drive_link)
---
## ✨ Key Features
### 👨🎓 For Students
| Feature | Description |
|---------|-------------|
| 🔐 **User Registration** | Easy and secure account creation process |
| 🔍 **Smart Tutor Search** | Advanced filtering by language, experience, pricing, and availability |
| 📅 **Flexible Scheduling** | Choose from 45, 60, or 90-minute lesson durations |
| 📚 **Interactive Flashcards** | Create, manage, and review language-specific flashcards |
| 📊 **Progress Tracking** | Monitor learning progress and test results |
### 👩🏫 For Tutors
| Feature | Description |
|---------|-------------|
| 🏫 **Class Management** | Set up and organize classes based on availability |
| 💰 **Dynamic Pricing** | Flexible pricing options based on teaching level |
| 📋 **Student Assessment** | Create personalized tests with detailed feedback |
| 📺 **Live Broadcasting** | Host live sessions for multiple students |
### 🌟 Core Platform Features
- **🎥 HD Video Calling**: Crystal-clear one-on-one video sessions with screen sharing
- **💳 Subscription Model**: Seamless subscription-based payment system powered by Stripe
- **📱 Responsive Design**: Optimized for all devices and screen sizes
- **🔔 Real-time Notifications**: Stay updated with class schedules and announcements
---
## 🚀 Advanced Features
### 📡 Live Broadcasting
- Tutors can host live sessions for multiple students simultaneously
- Flexible scheduling controlled by tutors
- Automated notifications for upcoming live sessions
### 📝 Personalized Assessment System
- Custom test creation by tutors
- Detailed question-by-question feedback
- Comprehensive test history and performance analytics
---
## 🛠️ Tech Stack
### Frontend
- **React 18.x** - Modern JavaScript library for building user interfaces
- **Redux Toolkit** - State management solution
- **React Router DOM** - Client-side routing
- **Axios** - HTTP client for API requests
- **Tailwind CSS** - Utility-first CSS framework
- **React Icons** - Popular icon library
- **React Toastify** - Notification system
### Backend
- **Node.js** - JavaScript runtime environment
- **Express.js** - Web application framework
- **MongoDB** - NoSQL database
- **Mongoose** - MongoDB object modeling
- **JWT** - JSON Web Tokens for authentication
- **Bcrypt** - Password hashing
- **Stripe** - Payment processing
### Development Tools
- **Nodemon** - Development server auto-restart
- **Concurrently** - Run multiple npm scripts
- **Prettier** - Code formatting
- **Winston** - Logging library
---
## 📁 Project Structure
```
TRINIT_BugBiters_Dev/
├── 📂 client/ # React frontend application
│ ├── 📂 public/ # Static assets
│ └── 📂 src/
│ ├── 📂 api/ # API service files
│ ├── 📂 components/ # Reusable React components
│ ├── 📂 pages/ # Page components
│ ├── 📂 store/ # Redux store and slices
│ ├── 📂 utils/ # Utility functions
│ ├── App.jsx # Main App component
│ └── index.js # Entry point
├── 📂 server/ # Node.js backend application
│ ├── 📂 controllers/ # Request handlers
│ ├── 📂 middleware/ # Custom middleware
│ ├── 📂 models/ # Database models
│ ├── 📂 routes/ # API routes
│ ├── 📂 utils/ # Backend utilities
│ └── index.js # Server entry point
├── package.json # Root package configuration
├── tailwind.config.js # Tailwind CSS configuration
└── README.md # Project documentation
```
---
## 🚀 Quick Start
### Prerequisites
Ensure you have the following installed:
- **Node.js** (v20.0.0 or higher) 📦
- **npm** (v10.0.0 or higher) 📦
- **MongoDB** (local or cloud instance) 🗄️
### Installation Steps
1. **Clone the repository**
```bash
git clone https://github.com/Sagargupta16/TRINIT_BugBiters_Dev.git
cd TRINIT_BugBiters_Dev
```
2. **Install all dependencies**
```bash
npm run fb-install
```
3. **Set up environment variables**
Create `.env` files in both `client` and `server` directories with necessary configurations:
**Server `.env`:**
```env
PORT=5000
MONGODB_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret
STRIPE_SECRET_KEY=your_stripe_secret_key
EMAIL_USER=your_email
EMAIL_PASS=your_email_password
```
4. **Start the development servers**
```bash
npm run start
```
5. **Access the application**
- Frontend: [http://localhost:3000](http://localhost:3000)
- Backend API: [http://localhost:5000](http://localhost:5000)
### Alternative Commands
```bash
# Install frontend dependencies only
npm run frontend-install
# Install backend dependencies only
npm run backend-install
# Start frontend only
npm run frontend-start
# Start backend only
npm run backend-start
# Build for production
npm run frontend-build
```
---
## 🤝 Contributing
We welcome contributions from the community! Here's how you can help:
### Development Workflow
1. **Fork the repository** to your GitHub account
2. **Create a feature branch** from `develop`:
```bash
git checkout -b feature-your-feature-name
```
3. **Implement your changes** following our coding standards
4. **Test thoroughly** to ensure no regressions
5. **Submit a pull request** with a clear description
### Branch Naming Convention
- `feature-*` for new features
- `bugfix-*` for bug fixes
- `hotfix-*` for urgent fixes
For detailed guidelines, please read our [Contributing Guide](CONTRIBUTING.md).
---
## 📄 License
This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
---
## 👥 Development Team
Meet the talented developers behind Lingua Connect:
Sagar Gupta
Project Lead & Full Stack Developer
Sachin Gupta
Frontend Developer
Rahul Raj
Backend Developer
---
## 🔗 Links & Resources
### 🌐 Live Application
- **Production**: [https://trinit-bugbiters-dev.onrender.com](https://trinit-bugbiters-dev.onrender.com)
### 📚 Documentation & References
- [MERN Stack Guide](https://www.mongodb.com/mern-stack)
- [React Documentation](https://reactjs.org/)
- [Node.js Documentation](https://nodejs.org/)
- [Express.js Guide](https://expressjs.com/)
- [MongoDB Manual](https://www.mongodb.com/)
- [Stripe Integration Guide](https://stripe.com/docs)
### 🛠️ Development Tools
- [React Router](https://reactrouter.com/)
- [Axios HTTP Client](https://axios-http.com/)
- [JWT Authentication](https://jwt.io/)
- [Bcrypt Hashing](https://www.npmjs.com/package/bcrypt)
- [Mongoose ODM](https://mongoosejs.com/)
- [Nodemailer](https://nodemailer.com/)
---
### 🌟 Star this repository if you found it helpful!
**Made with ❤️ by the BugBiters Team**