WebRTC conference room component for React projects. Out of the box support for Spreed WebRTC.
https://teamious.github.io/react-conf-webrtc/
To start developing, first make sure you have installed all of the dependencies:
npm install
Next, you should link your local package. This lets you develop + test your packages locally.
To link react-conf-webrtc first CD into the main project directory.
$ cd /path/to/react-conf-webrtc
Then run:
# You might need sudo
npm link
After that, change into the docs directory:
cd docs
and link the package:
npm link react-conf-webrtc
You will need to run a build in order to test with npm link:
cd ~/react-conf-webrtc
npm run build:watch
You can develop in one of two ways: with docker or without docker. The recommended dev environment is to use Docker on your machine. You can still develop even if you can't run Docker on your machine.
With Docker installed on your machine you can start the dev environment with the following command:
npm start
NOTE: This script assumes you are able to run docker with non-root access (you don't need to use sudo docker ...). You can learn how to do that here https://askubuntu.com/questions/477551/how-can-i-use-docker-without-sudo
This does the following:
- start webpack-dev-server
- pull the spreed/webrtc image from Docker registry
- run the spreed/webrtc image in a container
Please note that the boot time for the server can be a little slow. Once you see the following line you can know the server is up and running:
[1] server 2017/08/03 21:52:08 Starting HTTPS server on 0.0.0.0:8443
If you want to kill the dev environment simply press CTRL+C. This will kill webpack-dev-server
and will also stop the docker container. NOTE: Stopping the previous docker container can be slow.
Without Docker installed on your machine you can still develop in your local environment. You will need to go to the Spreed Github page and clone the repository.
Once you have cloned the repository, look at the README.md file to learn how to start the Spreed server. Once you have the Spreed server up and running you can start webpack-dev-server with:
npm run start:no-docker
This system requires that you manually start and stop your spreed server.
Regardless if you start with/without Docker, your frontend server is available on https://localhost:8080 and your backend Spreed server is available on https://localhost:8443. Since both servers use self-signed certificates you will need to manually accept the warnings for both servers when testing in browser.
Both servers listen on 0.0.0.0, therefore you can connect to the servers on your network by knowing your host's IP address (eg. navigating to https://192.168.220.116:8080 you will find Andrew's dev server). This lets you test your server with multiple machines on the same network.