From b1e55201cff757e69180c2f147a87116d1e0e109 Mon Sep 17 00:00:00 2001 From: William Kray Date: Sun, 1 Aug 2021 08:51:58 -0700 Subject: [PATCH 1/2] have a more descriptive readme with build/run instructions --- README.md | 42 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) diff --git a/README.md b/README.md index e39a653..5ae6d56 100644 --- a/README.md +++ b/README.md @@ -9,3 +9,45 @@ ## About Cinny is a [Matrix](https://matrix.org) client focusing primarily on simple, elegant and secure interface. + +## Building and Running + +### Running pre-compiled + +A pre-compiled version of the app exists in this repo. You can serve the application with a webserver of your choosing +by simply copying these files to the webroot: + + - `olm.wasm` + - `_redirects` + - all files in the `dist/` directory + +### Building from source + +Execute the following commands to compile the app from its source code: + +``` +npm install #installs all dependencies +npm build #compiles the app into the dist/ directory +``` + +To serve a development version of the app for testing, you may also use the command `npm start`. + +### Running with Docker + +This repository includes a Dockerfile, which builds the application from source and serves it with Nginx on port 80. To +use this locally, you can build the container like so: + +``` +docker build -t cinny:latest . +``` + +You can then run the container you've built with a command similar to this: + +``` +docker run -p 8080:80 cinny:latest +``` + +This will forward your `localhost` port 8080 to the container's port 80. You can visit the app in your browser by +navigating to `http://localhost:8080`. + + From cbfb25b3905e53874c1b4c2894412b6be9410cd5 Mon Sep 17 00:00:00 2001 From: William Kray Date: Sun, 1 Aug 2021 08:54:19 -0700 Subject: [PATCH 2/2] fix some wording in README --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 5ae6d56..a5350aa 100644 --- a/README.md +++ b/README.md @@ -30,7 +30,8 @@ npm install #installs all dependencies npm build #compiles the app into the dist/ directory ``` -To serve a development version of the app for testing, you may also use the command `npm start`. +You can then copy the files to a webserver's webroot of your choosing as noted above. +To serve a development version of the app locally for testing, you may also use the command `npm start`. ### Running with Docker