2021-07-28 16:15:52 +03:00
|
|
|
# Cinny
|
|
|
|
|
|
|
|
## Table of Contents
|
|
|
|
|
|
|
|
- [About](#about)
|
|
|
|
- [Getting Started](https://cinny.in)
|
|
|
|
- [Contributing](./CONTRIBUTING.md)
|
|
|
|
|
|
|
|
## About <a name = "about"></a>
|
|
|
|
|
2021-08-01 17:58:34 +03:00
|
|
|
Cinny is a [Matrix](https://matrix.org) client focusing primarily on simple, elegant and secure interface.
|
2021-08-01 18:51:58 +03:00
|
|
|
|
2021-09-12 18:48:45 +03:00
|
|
|
![preview](https://github.com/ajbura/cinny-site/blob/master/assets/preview-light.png)
|
2021-09-06 20:05:36 +03:00
|
|
|
|
2021-08-01 18:51:58 +03:00
|
|
|
## Building and Running
|
|
|
|
|
2021-09-15 14:47:31 +03:00
|
|
|
### Running pre-compiled
|
|
|
|
|
|
|
|
A tarball of pre-compiled version of the app is provided with each [release](https://github.com/ajbura/cinny/releases).
|
|
|
|
You can serve the application with a webserver of your choosing by simply copying `dist/` directory to the webroot.
|
|
|
|
|
2021-08-01 18:51:58 +03:00
|
|
|
### Building from source
|
|
|
|
|
|
|
|
Execute the following commands to compile the app from its source code:
|
|
|
|
|
2021-08-02 14:51:08 +03:00
|
|
|
```sh
|
|
|
|
npm install # Installs all dependencies
|
|
|
|
npm run build # Compiles the app into the dist/ directory
|
2021-08-01 18:51:58 +03:00
|
|
|
```
|
|
|
|
|
2021-08-03 06:12:12 +03:00
|
|
|
You can then copy the files to a webserver's webroot of your choice.
|
2021-08-01 18:54:19 +03:00
|
|
|
To serve a development version of the app locally for testing, you may also use the command `npm start`.
|
2021-08-01 18:51:58 +03:00
|
|
|
|
|
|
|
### 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`.
|
|
|
|
|
2021-09-15 14:47:31 +03:00
|
|
|
Alternatively you can just pull the [DockerHub image](https://hub.docker.com/r/ajbura/cinny) by `docker pull ajbura/cinny`.
|
|
|
|
|
2021-09-01 13:17:50 +03:00
|
|
|
## License
|
2021-08-01 18:51:58 +03:00
|
|
|
|
2021-09-01 13:17:50 +03:00
|
|
|
Copyright (c) 2021 Ajay Bura (ajbura) and other contributors
|
|
|
|
|
|
|
|
Code licensed under the MIT License: <http://opensource.org/licenses/MIT>
|
|
|
|
|
2021-09-15 14:47:31 +03:00
|
|
|
Graphics licensed under CC-BY 4.0: <https://creativecommons.org/licenses/by/4.0/>
|