Simplify readme and add various helpful links (#776)
* Simplyfy readme and add various helpful links * update intro * Add desktop app link
This commit is contained in:
parent
b3bff6b43f
commit
fd79ea4b9b
4 changed files with 37 additions and 36 deletions
|
@ -36,4 +36,9 @@ It is not always possible to phrase every change in such a manner, but it is des
|
||||||
|
|
||||||
Also, we use [ESLint](https://eslint.org/) for clean and stylistically consistent code syntax, so make sure your pull request follow it.
|
Also, we use [ESLint](https://eslint.org/) for clean and stylistically consistent code syntax, so make sure your pull request follow it.
|
||||||
|
|
||||||
**For any query or design discussion, join our [Matrix room](https://matrix.to/#/#cinny:matrix.org).**
|
**For any query or design discussion, join our [Matrix room](https://matrix.to/#/#cinny:matrix.org).**
|
||||||
|
|
||||||
|
## Helpful links
|
||||||
|
- [BEM methodology](http://getbem.com/introduction/)
|
||||||
|
- [Atomic design](https://bradfrost.com/blog/post/atomic-web-design/)
|
||||||
|
- [Matrix JavaScript SDK documentation](https://matrix-org.github.io/matrix-js-sdk/19.2.0/index.html)
|
2
LICENSE
2
LICENSE
|
@ -1,6 +1,6 @@
|
||||||
MIT License
|
MIT License
|
||||||
|
|
||||||
Copyright (c) 2021 Ajay Bura (ajbura)
|
Copyright (c) 2021-present Ajay Bura (ajbura)
|
||||||
|
|
||||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
of this software and associated documentation files (the "Software"), to deal
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
|
62
README.md
62
README.md
|
@ -1,9 +1,5 @@
|
||||||
<p align="center">
|
# Cinny
|
||||||
<img src="https://raw.githubusercontent.com/ajbura/cinny/dev/public/res/svg/cinny.svg?sanitize=true"
|
<p>
|
||||||
height="16">
|
|
||||||
<span><b>Cinny</b></span>
|
|
||||||
</p>
|
|
||||||
<p align="center">
|
|
||||||
<a href="https://github.com/ajbura/cinny/releases">
|
<a href="https://github.com/ajbura/cinny/releases">
|
||||||
<img alt="GitHub release downloads" src="https://img.shields.io/github/downloads/ajbura/cinny/total?logo=github&style=social"></a>
|
<img alt="GitHub release downloads" src="https://img.shields.io/github/downloads/ajbura/cinny/total?logo=github&style=social"></a>
|
||||||
<a href="https://hub.docker.com/r/ajbura/cinny">
|
<a href="https://hub.docker.com/r/ajbura/cinny">
|
||||||
|
@ -16,21 +12,30 @@
|
||||||
<img alt="Sponsor Cinny" src="https://img.shields.io/opencollective/all/cinny?logo=opencollective&style=social"></a>
|
<img alt="Sponsor Cinny" src="https://img.shields.io/opencollective/all/cinny?logo=opencollective&style=social"></a>
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
**Cinny** is a Matrix client focusing primarily on simple, elegant and secure interface. The main goal is to have a client that is easy on end user
|
A Matrix client focusing primarily on simple, elegant and secure interface. The main goal is to have an instant messaging application that is easy on people and has a modern touch.
|
||||||
and feels a modern chat application.
|
|
||||||
|
|
||||||
- [Contributing](./CONTRIBUTING.md)
|
|
||||||
- [Roadmap](https://github.com/ajbura/cinny/projects/11)
|
- [Roadmap](https://github.com/ajbura/cinny/projects/11)
|
||||||
|
- [Contributing](./CONTRIBUTING.md)
|
||||||
|
|
||||||
## Building and Running
|
## Getting started
|
||||||
|
Web app is available at https://app.cinny.in and gets updated on each new release. The `dev` branch is continuously deployed at https://dev.cinny.in but keep in mind that it could have things broken.
|
||||||
|
|
||||||
### Running pre-compiled
|
You can also download our desktop app from [cinny-desktop repository](https://github.com/cinnyapp/cinny-desktop).
|
||||||
|
|
||||||
A tarball of pre-compiled version of the app is provided with each [release](https://github.com/ajbura/cinny/releases).
|
To host Cinny on your own, download tarball of the app from [GitHub release](https://github.com/cinnyapp/cinny/releases/latest).
|
||||||
You can serve the application with a webserver of your choosing by simply copying `dist/` directory to the webroot.
|
You can serve the application with a webserver of your choice by simply copying `dist/` directory to the webroot.
|
||||||
|
To set default Homeserver on login and register page, place a customized [`config.json`](config.json) in webroot of your choice.
|
||||||
|
|
||||||
|
Alternatively you can just pull the [DockerHub image](https://hub.docker.com/r/ajbura/cinny) by:
|
||||||
|
```
|
||||||
|
docker pull ajbura/cinny
|
||||||
|
```
|
||||||
|
or [ghcr image](https://github.com/cinnyapp/cinny/pkgs/container/cinny) by:
|
||||||
|
```
|
||||||
|
docker pull ghcr.io/cinnyapp/cinny:latest
|
||||||
|
```
|
||||||
|
|
||||||
<details>
|
<details>
|
||||||
<summary>PGP Public Key to verify pre-compiled tarball</summary>
|
<summary>PGP Public Key to verify tarball</summary>
|
||||||
|
|
||||||
```
|
```
|
||||||
-----BEGIN PGP PUBLIC KEY BLOCK-----
|
-----BEGIN PGP PUBLIC KEY BLOCK-----
|
||||||
|
@ -77,48 +82,39 @@ UeGsouhyuITLwEhScounZDqop+Dx
|
||||||
```
|
```
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
### Building from source
|
## Local development
|
||||||
> We recommend using a version manager as versions change very quickly. You will likely need to switch
|
> We recommend using a version manager as versions change very quickly. You will likely need to switch
|
||||||
between multiple Node.js versions based on the needs of different projects you're working on. [NVM on windows](https://github.com/coreybutler/nvm-windows#installation--upgrades) on Windows and [nvm](https://github.com/nvm-sh/nvm) on Linux/macOS are pretty good choices. Also recommended nodejs version is 16.15.0 LTS.
|
between multiple Node.js versions based on the needs of different projects you're working on. [NVM on windows](https://github.com/coreybutler/nvm-windows#installation--upgrades) on Windows and [nvm](https://github.com/nvm-sh/nvm) on Linux/macOS are pretty good choices. Also recommended nodejs version is 16.15.0 LTS.
|
||||||
|
|
||||||
Execute the following commands to compile the app from its source code:
|
Execute the following commands to start a development server:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
npm ci # Installs all dependencies
|
npm ci # Installs all dependencies
|
||||||
|
npm start # Serve a development version
|
||||||
|
```
|
||||||
|
|
||||||
|
To build the app:
|
||||||
|
```sh
|
||||||
npm run build # Compiles the app into the dist/ directory
|
npm run build # Compiles the app into the dist/ directory
|
||||||
```
|
```
|
||||||
|
|
||||||
You can then copy the files to a webserver's webroot of your choice.
|
|
||||||
|
|
||||||
To serve a development version of the app locally for testing, you need to use the command `npm start`.
|
|
||||||
|
|
||||||
### Running with Docker
|
### Running with Docker
|
||||||
|
|
||||||
This repository includes a Dockerfile, which builds the application from source and serves it with Nginx on port 80. To
|
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:
|
use this locally, you can build the container like so:
|
||||||
|
|
||||||
```
|
```
|
||||||
docker build -t cinny:latest .
|
docker build -t cinny:latest .
|
||||||
```
|
```
|
||||||
|
|
||||||
You can then run the container you've built with a command similar to this:
|
You can then run the container you've built with a command similar to this:
|
||||||
|
|
||||||
```
|
```
|
||||||
docker run -p 8080:80 cinny:latest
|
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
|
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`.
|
||||||
navigating to `http://localhost:8080`.
|
|
||||||
|
|
||||||
Alternatively you can just pull the [DockerHub image](https://hub.docker.com/r/ajbura/cinny) by `docker pull ajbura/cinny`.
|
|
||||||
|
|
||||||
### Configuring default Homeserver
|
|
||||||
|
|
||||||
To set default Homeserver on login and register page, place a customized [`config.json`](config.json) in webroot of your choice.
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
Copyright (c) 2021 Ajay Bura (ajbura)
|
Copyright (c) 2021-present Ajay Bura (ajbura)
|
||||||
|
|
||||||
Code licensed under the MIT License: <http://opensource.org/licenses/MIT>
|
Code licensed under the MIT License: <http://opensource.org/licenses/MIT>
|
||||||
|
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
Graphics (c) by Ajay Bura (ajbura)
|
Copyright (c) 2021-present Ajay Bura (ajbura)
|
||||||
|
|
||||||
Graphic content is licensed under a
|
Graphic content is licensed under a
|
||||||
Creative Commons Attribution 4.0 International License.
|
Creative Commons Attribution 4.0 International License.
|
||||||
|
|
Loading…
Reference in a new issue