Cinny

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.

• Roadmap
• Contributing

Getting started

• Web app is available at https://cinny.yiffing.dev and gets updated on each new release.

• To host Cinny on your own, download tarball of the app from GitHub release. 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, register and Explore Community page, place a customized config.json in webroot of your choice. You will also need to setup redirects to serve the assests. An example setting of redirects for netlify is done in netlify.toml. You can also set hashRouter.enabled = true in config.json if you have trouble setting redirects. To deploy on subdirectory, you need to rebuild the app youself after updating the base path in build.config.ts. For example, if you want to deploy on https://cinny.in/app, then change base: '/app'.

Local development

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 on Windows and nvm on Linux/macOS are pretty good choices. Recommended nodejs version is Iron LTS (v20).

Execute the following commands to start a development server:

npm ci # Installs all dependencies
npm start # Serve a development version

To build the app:

npm run build # Compiles the app into the dist/ directory

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.

Or use Docker Compose

services:
  cinny:
    image: git.yiffing.dev/leafus/cinny-improved:latest
    restart: always
    ports:
      - 8444:80