https://github.com/deepakkumar55/bseb-study-campanion
https://github.com/deepakkumar55/bseb-study-campanion
Last synced: 10 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/deepakkumar55/bseb-study-campanion
- Owner: deepakkumar55
- License: mit
- Created: 2025-05-08T10:39:44.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-08T19:29:24.000Z (about 1 year ago)
- Last Synced: 2025-06-21T00:11:27.783Z (about 1 year ago)
- Language: TypeScript
- Homepage: https://bseb.thecampuscoders.com/
- Size: 74.2 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 📘 BSEB Study Companion – Class 12 (by TheCampusCoders)
**BSEB Study Companion** is a free, open-source learning platform built by [TheCampusCoders](https://twitter.com/thecampuscoders), tailored for **Bihar Board Class 12** students.
It provides a modern and structured approach to exam prep, featuring:
- ✅ Previous Year Papers & Detailed Solutions
- ✅ Chapter-wise Tests & Smart Quizzes
- ✅ Handwritten & Digital Notes
- ✅ Personalized Dashboard for Progress Tracking
> Built with **Next.js**, styled using **Tailwind CSS**, deployed on **Vercel**, and powered by **MongoDB**.
---
## 🚀 Features
### 📄 Previous Year Papers
- Subject-wise papers with download option
- Year-wise filtering
- Includes solutions
### 🧪 Chapter-wise Tests
- Auto-generated tests for each chapter
- Track performance and retry for improvement
### 🎯 MCQ Quizzes
- Exam-pattern MCQs
- Instant result + correct answer explanation
### 📝 Notes Section
- Handwritten & typed notes
- Organized by subject → chapter → topic
### 👤 User Dashboard
- Save bookmarks, test scores, quiz history
- JWT-based authentication
---
## 🧑💻 Tech Stack
| Category | Technology |
|--------------|------------------------|
| Frontend | Next.js (App Router) |
| Styling | Tailwind CSS |
| Backend API | Next.js API Routes |
| Database | MongoDB + Mongoose |
| Auth | JWT + bcrypt.js |
| File Upload | Cloudinary + Multer |
| Hosting | Vercel |
---
## 🛠 Getting Started
### 1. Clone the repository
```bash
git clone https://github.com/deepakkumar55/bseb-study-campanion.git
cd bseb-study-companion
````
### 2. Install dependencies
```bash
npm install
```
### 3. Configure environment variables
Create a `.env.local` file in the root directory and add the following:
```env
MONGODB_URI=your_mongodb_connection
JWT_SECRET=your_jwt_secret
```
### 4. Start the development server
```bash
npm run dev
```
Visit `http://localhost:3000` in your browser.
---
## 🌍 Deployment (Vercel)
To deploy your own version on [Vercel](https://vercel.com):
1. Push the code to GitHub
2. Import the repo on Vercel
3. Add environment variables in the Vercel dashboard
4. Deploy with one click ✅
---
## 🤝 Contributing
> Please refer to [`CONTRIBUTING.md`](CONTRIBUTING.md) for detailed contribution guidelines.
---
## 👨💻 Contributors
Thanks to these amazing people for making this project better!
Want to join the list? [Start here →](https://github.com/deepakkumar55/bseb-study-campanion/graphs/contributors)
Deepak Kumar
💻 Project Owner
---
## 📜 License
This project is licensed under the **MIT License**.
You're free to use, modify, and distribute it with attribution.
---
## 📬 Contact
* Twitter: [@thecampuscoders](https://twitter.com/thecampuscoders)
* Instagram: [@campus\_store\_official](https://instagram.com/thecampuscoders)
* Email: [support@thecampuscoders.com](mailto:support@thecampuscoders.com)
---
> 🧠 **"Digital Saathi for every BSEB student."**
> Made with ❤️ by [The Campus Coders](https://thecampuscoders.com)