2022-12-10 11:17:42 +00:00
|
|
|
# excalidraw-collaboration
|
|
|
|
|
|
|
|
One click to init an excalidraw with collaboration.
|
|
|
|
|
2022-12-10 14:08:01 +00:00
|
|
|
Snapshot:
|
|
|
|
|
|
|
|
![snapshot](./_assets/snapshot.png)
|
|
|
|
|
|
|
|
Demo:
|
|
|
|
|
2023-02-01 15:26:25 +00:00
|
|
|
[Live Demo](https://draw2.dmitrysamoylenko.in/)
|
|
|
|
A live room sample here: [live room](https://draw2.dmitrysamoylenko.in/#room=f8671f3fdef3ada5128c,Dyn8aqg8RII9rzUVIl9i7w)
|
|
|
|
|
|
|
|
Thanks a lot to @samoylenkodmitry.
|
2022-12-10 14:08:01 +00:00
|
|
|
|
|
|
|
Related docs:
|
2022-12-10 11:17:42 +00:00
|
|
|
|
|
|
|
- [Self hosted online collaborative drawing platform Excalidraw | Log4D](https://en.blog.alswl.com/2022/10/self-hosted-excalidraw/)
|
|
|
|
- [私有化在线协同画图平台 Excalidraw | Log4D]( https://blog.alswl.com/2022/10/self-hosted-excalidraw/ )
|
|
|
|
|
2022-12-10 14:08:01 +00:00
|
|
|
|
|
|
|
## Build and Run
|
|
|
|
|
|
|
|
Clone, patch, and build:
|
2022-12-10 11:17:42 +00:00
|
|
|
|
|
|
|
```
|
2022-12-10 14:08:01 +00:00
|
|
|
git clone --recursive git@github.com:alswl/excalidraw-collaboration.git
|
|
|
|
cd excalidraw-collaboration
|
2022-12-10 13:49:20 +00:00
|
|
|
git config submodule.excalidraw.ignore all # ignore submodule changes, we will patch them
|
2022-12-10 12:09:23 +00:00
|
|
|
|
2023-02-01 16:51:11 +00:00
|
|
|
# $EDITOR excalidraw.env.production # (optional) edit service endpoint
|
|
|
|
|
|
|
|
make patch images # patch to configurations and build the container image
|
|
|
|
make update-docker-compose-version # update images version for docker-compose
|
|
|
|
docker-compose up # run the containers
|
|
|
|
|
|
|
|
open "http://localhost" # open browser, and you can using the Team work functions
|
|
|
|
```
|
|
|
|
|
|
|
|
Bump version:
|
|
|
|
|
2023-10-07 14:43:52 +00:00
|
|
|
excalidraw-collaboration always follow the excalidraw version, so you can only bump the appendix version.
|
|
|
|
|
2023-02-01 16:51:11 +00:00
|
|
|
```
|
|
|
|
# make sure all changes are commited
|
|
|
|
make images # build new image without dirty
|
|
|
|
|
|
|
|
make bump-version # bump version if your configuration changes(the changes will build into
|
|
|
|
git commit -a -m 'feat: bump with my local config' # save your changes
|
2022-12-10 11:17:42 +00:00
|
|
|
```
|
2022-12-10 13:49:20 +00:00
|
|
|
|
2022-12-10 14:08:01 +00:00
|
|
|
Browse it:
|
2022-12-10 13:49:20 +00:00
|
|
|
|
|
|
|
- open http://127.0.0.1/ ,and you will see the excalidraw page
|
|
|
|
- Click the `Live Collaboration` button, and you will see the collaboration page
|
|
|
|
- Now you can share the collaboration page with your friends, and you can draw together.
|
|
|
|
|
|
|
|
|
2022-12-10 14:08:01 +00:00
|
|
|
About public network release:
|
2022-12-10 13:49:20 +00:00
|
|
|
|
|
|
|
if you want to release your own excalidraw in public network,
|
2023-01-22 17:51:29 +00:00
|
|
|
you should modify the `excalidraw.env.production` file,
|
|
|
|
Replace the `REACT_APP_HTTP_STORAGE_BACKEND_URL` and `REACT_APP_WS_SERVER_URL` with your own domain.
|