Skip to content

Commit 959fbbf

Browse files
committed
2 parents 6166c04 + 4042f68 commit 959fbbf

File tree

1 file changed

+106
-14
lines changed

1 file changed

+106
-14
lines changed

README.md

Lines changed: 106 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,119 @@
1-
# CollaborativeEditor
1+
# ✍️ Collaborative Editor UI
22

3-
This project was generated with [Angular CLI](https://github.com/angular/angular-cli) version 18.1.4.
3+
Welcome to **Collaborative Editor** - a real-time collaborative document editor that brings Google Docs-like experience to life using **Angular**, **WebSockets**, and a robust **Spring Boot** backend.
44

5-
## Development server
5+
> 🔧 This is the **Frontend (UI)** of the project. You can find the backend here: [CollabEditor Backend](https://github.com/thughari/CollabEditor)
66
7-
Run `ng serve` for a dev server. Navigate to `http://localhost:4200/`. The application will automatically reload if you change any of the source files.
7+
---
88

9-
## Code scaffolding
9+
## 🌍 Live App
1010

11-
Run `ng generate component component-name` to generate a new component. You can also use `ng generate directive|pipe|service|class|guard|interface|enum|module`.
11+
> 🚀 https://thughari.github.io/Collaborative-Editor-UI
1212
13-
## Build
13+
---
1414

15-
Run `ng build` to build the project. The build artifacts will be stored in the `dist/` directory.
15+
## 🛠️ Tech Stack
1616

17-
## Running unit tests
17+
**Frontend:**
1818

19-
Run `ng test` to execute the unit tests via [Karma](https://karma-runner.github.io).
19+
* ⚙️ Angular
20+
* 📡 WebSocket integration
21+
* 💅 CSS + Tailwind
2022

21-
## Running end-to-end tests
23+
**Backend:**
2224

23-
Run `ng e2e` to execute the end-to-end tests via a platform of your choice. To use this command, you need to first add a package that implements end-to-end testing capabilities.
25+
* ☕ Java 17
26+
* 🧩 Spring Boot
27+
* 🔄 WebSocket (Spring's ```TextWebSocketHandler```)
28+
* 💾 MongoDB (for persistence)
29+
* 🌐 Deployed via Render
2430

25-
## Further help
31+
---
2632

27-
To get more help on the Angular CLI use `ng help` or go check out the [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli) page.
33+
## 💡 Features
34+
35+
* 📝 Real-time collaborative editing
36+
* 👥 Multiple users editing the same document simultaneously
37+
* 🔗 Unique document URLs for shared sessions
38+
* 🔒 Auto-save and document restoration
39+
* ⚙️ WebSocket-based communication for instant updates
40+
41+
---
42+
43+
## 🧑‍💻 Local Setup
44+
45+
### 1. Clone the Repositories
46+
47+
```bash
48+
# Frontend
49+
git clone https://github.com/thughari/Collaborative-Editor-UI.git
50+
51+
# Backend
52+
git clone https://github.com/thughari/CollabEditor.git
53+
```
54+
55+
### 2. Run Backend (Spring Boot)
56+
57+
```bash
58+
cd CollabEditor
59+
./mvnw spring-boot:run
60+
```
61+
62+
The backend runs on `http://localhost:8080`.
63+
64+
> ⚠️ Ensure MongoDB is running locally or configure it in `application.properties`.
65+
66+
### 3. Run Frontend (Angular)
67+
68+
```bash
69+
cd Collaborative-Editor-UI
70+
npm install
71+
ng serve
72+
```
73+
74+
Frontend runs on `http://localhost:4200`.
75+
76+
---
77+
78+
## 🧪 How It Works
79+
80+
1. Open `http://localhost:4200`.
81+
2. You’re assigned a unique document ID.
82+
3. Share the URL with others.
83+
4. Everyone edits the same document in real time.
84+
5. Backend syncs and persists content using WebSockets and MongoDB.
85+
86+
---
87+
88+
## 📸 Screenshots
89+
90+
| Chat Window | Responsive Design |
91+
|-------------|------------------|
92+
| ![Chat Window](public/images/desktop-window.png) | ![Responsive Design](public/images/mobile-window.png) |
93+
94+
---
95+
96+
## 🧑‍🤝‍🧑 Contributing
97+
98+
We welcome contributions! Here's how to get started:
99+
100+
```bash
101+
git checkout -b feature/your-feature
102+
git commit -m "Add new feature"
103+
git push origin feature/your-feature
104+
```
105+
106+
Then open a Pull Request ✅
107+
108+
---
109+
110+
## 👨‍💻 Developed by
111+
112+
**Hari Thatikonda**
113+
📫 [LinkedIn](https://linkedin.com/in/hari-thatikonda) | [GitHub](https://github.com/thughari)
114+
115+
---
116+
117+
## 📝 License
118+
119+
MIT — use it freely, improve it collaboratively.

0 commit comments

Comments
 (0)