diff --git a/README.md b/README.md
index 30082b5..4a71f3f 100644
--- a/README.md
+++ b/README.md
@@ -1,86 +1,269 @@
-# StudyBuddy
+# StudyBuddy ๐
+
-
+## ๐ About the Project
-## ๐About the project
+StudyBuddy is a collaborative web platform designed to help students find study partners and create dedicated study rooms for any topic. Built with Django and deployed on Azure, this application bridges the gap between learners seeking collaborative study opportunities.
-StudyBuddy is a web application that allows students to find study partners for any topic of their choice. The application is built using the Django framework and is deployed on Azure. The application is also containerized using Docker and is deployed using Github Actions.
+**Problem Statement:** Students often struggle to find like-minded peers for collaborative learning on specific topics.
- > StudyBuddy solves the problem of students not being able to find study partners for a particular topic. The application allows students to find study partners for any topic of their choice. The application also allows students to create study groups for a particular topic.
+**Solution:** StudyBuddy provides an intuitive platform where students can discover study partners, create topic-specific study rooms, engage in real-time discussions, and build a community around shared learning goals.
---
-## ๐ฎFeatures
+## ๐ฎ Features
-- **Easy to use** - The user interface of the project is very simple and easy to use.
-- **Used Docker** - The project is containerized using Docker.
-- **Implementated CI/CD** - The project is also integrated with GitHub Actions for continuous integration and continuous deployment.
-- **Deployed on Azure** - The project is deployed on Azure using GitHub Actions.
-- **Responsive** - The project is responsive and can be used on any device.
-- **Login/Signup** - The user can login or signup to the application and create a profile.
-- **Create/Join Study Rooms** - The user can create/join study rooms for a particular topic and interact with other users.
-- **Profile** - The user can view their profile and edit their profile.
-- **Search** - The user can search for a particular topic and find study rooms for that topic.
+- **User Authentication** - Secure login and signup system with personalized user profiles
+- **Study Room Management** - Create, join, and participate in topic-specific study rooms
+- **Real-time Messaging** - Interactive communication within study rooms
+- **Topic-based Search** - Find study rooms by searching for specific subjects or topics
+- **User Profiles** - View and edit personal profiles, track participation history
+- **Responsive Design** - Seamless experience across desktop, tablet, and mobile devices
+- **REST API** - Comprehensive API for programmatic access and integration
+- **Docker Support** - Containerized deployment for consistent environments
+- **CI/CD Pipeline** - Automated testing and deployment via GitHub Actions
+- **Cloud Deployment** - Production-ready deployment on Azure
---
-## ๐ธScreenshots
+## ๐ Project Structure
->Login Page
+```text
+StudyBuddy/
+โโโ StudyBuddy/ # Project configuration
+โ โโโ settings.py # Django settings
+โ โโโ urls.py # Root URL configuration
+โ โโโ asgi.py # ASGI config
+โ โโโ wsgi.py # WSGI config
+โโโ base/ # Main application
+โ โโโ api/ # REST API
+โ โ โโโ serializers.py # Data serializers
+โ โ โโโ urls.py # API routes
+โ โ โโโ views.py # API views
+โ โโโ migrations/ # Database migrations
+โ โโโ templates/base/ # HTML templates
+โ โโโ models.py # Database models
+โ โโโ views.py # View logic
+โ โโโ urls.py # App URL patterns
+โ โโโ forms.py # Form definitions
+โโโ static/ # Static assets
+โ โโโ images/ # Icons and avatars
+โ โโโ js/ # JavaScript files
+โ โโโ styles/ # CSS stylesheets
+โโโ templates/ # Global templates
+โ โโโ main.html # Base layout
+โ โโโ navbar.html # Navigation component
+โโโ manage.py # Django CLI utility
+โโโ Dockerfile # Docker configuration
+โโโ requirements.txt # Python dependencies
+โโโ README.md # This file
+```
+
+**Key Directories:**
+- `base/`: Core application logic including models, views, and templates
+- `base/api/`: REST API implementation using Django REST Framework
+- `static/`: Frontend assets (CSS, JavaScript, images)
+- `templates/`: Global HTML layouts and reusable components
+
+---
+
+## ๐ธ Screenshots
+
+
+Click to view screenshots
+
+### Login Page
->Signup Page
+### Signup Page
->Home Page
+### Home Page
->Profile Page
+### Profile Page
->Create Study Room
+### Create Study Room
->Study Room
+### Study Room
->Edit Profile
+### Edit Profile
+
+
---
-## ๐ฅDemo
-
-[](https://www.youtube.com/watch?v=GReHXtIDayg)
+## ๐ฅ Demo
----
+[](https://www.youtube.com/watch?v=GReHXtIDayg)
-## ๐Installation
+Watch the full demonstration video on YouTube:
-- Clone the repository
+[](https://www.youtube.com/watch?v=GReHXtIDayg)
-```bash
-git clone https://github.com/abhikalparya/StudyBuddy.git
-```
+---
+
+## ๐ Setup & Installation
+
+### Prerequisites
+
+- Python 3.8 or higher
+- pip (Python package manager)
+- Git
+- Docker (optional, for containerized deployment)
+
+### Option A: Local Development
+
+1. **Clone the Repository**
+ ```bash
+ git clone https://github.com/abhikalparya/StudyBuddy.git
+ cd StudyBuddy
+ ```
+
+2. **Create Virtual Environment**
+ ```bash
+ python -m venv venv
+
+ # On Windows
+ venv\Scripts\activate
+
+ # On macOS/Linux
+ source venv/bin/activate
+ ```
+
+3. **Install Dependencies**
+ ```bash
+ pip install -r requirements.txt
+ ```
+
+4. **Initialize Database**
+ ```bash
+ python manage.py migrate
+ python manage.py createsuperuser
+ ```
+
+5. **Run Development Server**
+ ```bash
+ python manage.py runserver
+ ```
+
+6. **Access the Application**
+
+ Open your browser and navigate to `http://localhost:8000`
+
+### Option B: Docker Deployment (Recommended)
+
+1. **Build Docker Image**
+ ```bash
+ docker build -t studybuddy-app .
+ ```
+
+2. **Run Container**
+ ```bash
+ docker run -p 8000:8000 studybuddy-app
+ ```
+
+3. **Access the Application**
+
+ Open your browser and navigate to `http://localhost:8000`
+
+> [!TIP]
+> For production deployment, ensure you configure environment variables for `SECRET_KEY`, `DEBUG`, and database settings.
+
+---
+
+## ๐ API Documentation
+
+StudyBuddy provides a REST API for programmatic access:
-- Install the requirements
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/` | GET | API root - lists all available endpoints |
+| `/api/rooms/` | GET | Returns all study rooms with metadata |
+| `/api/rooms//` | GET | Detailed information for a specific room |
+
+### Example API Request
```bash
-pip install -r requirements.txt
+curl http://localhost:8000/api/rooms/
```
-- Run the server
+### Example API Response
-```bash
-python manage.py runserver
+```json
+[
+ {
+ "id": 1,
+ "name": "Python Programming Study Group",
+ "topic": "Python",
+ "host": "john_doe",
+ "participants": 5,
+ "created": "2026-01-10T10:30:00Z"
+ }
+]
```
+
+---
+
+
+## ๐ Bug Reports
+
+Found a bug? Please open an [issue](https://github.com/abhikalparya/StudyBuddy/issues) with:
+- Clear description of the bug
+- Steps to reproduce
+- Expected vs actual behavior
+- Screenshots (if applicable)
+
+---
+
+## ๐ License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+## ๐จโ๐ป Author
+
+**Abhikal Parya**
+
+- GitHub: [@abhikalparya](https://github.com/abhikalparya)
+
+---
+
+## ๐ Acknowledgments
+
+- Django community for excellent documentation
+- All contributors who helped improve this project
+- ESWoC'26 for providing a platform for open-source contribution
+
+---
+
+## ๐ Support
+
+For questions or support, please:
+- Open an issue on GitHub
+- Reach out via the repository discussions
+
+---
+
+
+
+**If you find this project helpful, please give it a โญ!**
+
+Made with โค๏ธ for students, by students
+
+
\ No newline at end of file