Repolode
Submit
cinnyapp

cinnyapp/cinny

A simple, elegant web client for the Matrix open messaging protocol, built with React and TypeScript.

Open-source alternative to:SlackDiscord

View on GitHubWebsite
Stars
3,937
Forks
596
Open issues
363
Last commit
9 hours ago

What is it?

Cinny is a Matrix client focused on a simple, elegant and secure interface for instant messaging. It runs as a web app that can be used at app.cinny.in, and a separate desktop app is available from its cinny-desktop repository.

The project can be self-hosted: you build it or download a release tarball and serve the files from the dist folder with any web server, or run the Docker image from DockerHub or GitHub Container Registry. Default homeservers and explore pages are set in config.json, and example redirect configurations are provided for Netlify, nginx and Caddy. Hash routing can be enabled if redirect setup is difficult, and the app can be deployed under a subdirectory by changing the base path.

The project is licensed under AGPL-3.0. At the time of its README, the maintainers were replacing the matrix-js-sdk with their own SDK and were not accepting pull requests until further notice.

Key features

  • 01Web client for the Matrix messaging protocol with a clean, modern interface.
  • 02Static build that can be served from any web server.
  • 03Official Docker images on DockerHub and GitHub Container Registry.
  • 04Configurable default homeservers and explore pages via config.json.
  • 05Hash routing option for hosts without custom redirect rules.
  • 06Desktop app available in a separate repository.

Use cases

  • Running a self-hosted chat web client for a team or community on a Matrix homeserver.
  • Using a lightweight Matrix client in the browser without installing software.
  • Customizing and deploying a Matrix web client under a subdirectory of an existing domain.

Quick start

  1. 1

    Download the tarball from GitHub releases and serve the files in dist/ with a webserver

  2. 2

    Or pull the Docker image from DockerHub

    docker pull ajbura/cinny
  3. 3

    Or use the hosted web app at app.cinny.in

Things to know

  • The project is replacing its matrix-js-sdk dependency, and pull requests are not being accepted until further notice.
  • Self-hosting requires configuring redirects on your webserver, or enabling hash routing.

Topics

#matrix#chat#messaging#react#typescript#web-client#self-hosted#cinny#cinnyapp#client

FAQ

What is cinny?
A simple, elegant web client for the Matrix open messaging protocol, built with React and TypeScript. Cinny is a Matrix client focused on a simple, elegant and secure interface for instant messaging. It runs as a web app that can be used at app.cinny.in, and a separate desktop app is available from its cinny-desktop repository.
Is cinny free to use? What license does it have?
cinny is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is cinny still maintained?
Actively maintained. The last commit to cinny was on Oct 19, 2026.
What can I use cinny for?
Running a self-hosted chat web client for a team or community on a Matrix homeserver. Using a lightweight Matrix client in the browser without installing software. Customizing and deploying a Matrix web client under a subdirectory of an existing domain.
How do I install cinny?
Download the tarball from GitHub releases and serve the files in dist/ with a webserver Or pull the Docker image from DockerHub: docker pull ajbura/cinny Or use the hosted web app at app.cinny.in
Where can I get cinny?
The source code and installation instructions are on GitHub: https://github.com/cinnyapp/cinny

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects