vector-im-hydrogen-web/README.md

23 lines
1.3 KiB
Markdown
Raw Normal View History

2019-06-14 23:58:39 +02:00
# Brawl
2019-09-08 10:52:06 +02:00
A minimal [Matrix](https://matrix.org/) chat client, focused on performance, offline functionality and working on my Lumia 950 Windows Phone.
2019-01-09 11:10:33 +01:00
## Status
2019-09-08 10:52:06 +02:00
Brawl can currently log you in, or pick an existing session, sync already joined rooms, fill gaps in the timeline, and send text messages. Everything is stored locally.
2020-06-03 14:38:47 +02:00
Here's an (outdated) GIF of what that looks like, also see link below to try it out:
2019-09-08 10:52:06 +02:00
![Showing multiple sessions, and sending messages](https://bwindels.github.io/brawl-chat/images/brawl-sending.gif)
2019-02-10 22:02:42 +01:00
2019-09-08 10:52:06 +02:00
## Why
2019-02-13 14:10:23 +01:00
2019-09-08 11:54:51 +02:00
I started writing Brawl both to have a functional matrix client on my aging phone, and to play around with some ideas I had how to use indexeddb optimally in a matrix client.
For every interaction or network response (syncing, filling a gap), Brawl starts a transaction in indexedb, and only commits it once everything went well. This helps to keep your storage always in a consistent state. As little data is kept in memory as well, and while scrolling in the above GIF, everything is loaded straight from the storage.
2019-02-13 14:10:23 +01:00
2019-09-08 10:52:06 +02:00
If you find this interesting, feel free to reach me at `@bwindels:matrix.org`.
2019-09-08 11:54:18 +02:00
# How to use
2019-11-22 09:01:57 +01:00
You can [try Brawl here](https://bwindels.github.io/brawl/), or try it locally by running `yarn install` (only the first time) and `yarn start` in the terminal, and point your browser to `http://localhost:3000`.