||2 days ago|
|.github/workflows||8 months ago|
|doc||2 months ago|
|prototypes||9 months ago|
|scripts||1 week ago|
|src||4 days ago|
|.dockerignore||1 year ago|
|.editorconfig||3 years ago|
|.eslintrc.js||4 months ago|
|.gitignore||2 days ago|
|.gitlab-ci.yml||1 year ago|
|.ts-eslintrc.js||11 months ago|
|CONTRIBUTING.md||4 months ago|
|Dockerfile||9 months ago|
|Dockerfile-dev||9 months ago|
|LICENSE||2 years ago|
|README.md||1 month ago|
|TODO.md||2 years ago|
|codestyle.md||7 months ago|
|package.json||5 days ago|
|tsconfig-declaration.json||6 months ago|
|tsconfig.json||6 months ago|
|view-gallery.html||8 months ago|
|vite.common-config.js||2 weeks ago|
|vite.config.js||1 month ago|
|vite.sdk-assets-config.js||2 months ago|
|vite.sdk-lib-config.js||3 months ago|
|yarn.lock||2 months ago|
A minimal Matrix chat client, focused on performance, offline functionality, and broad browser support. This is work in progress and not yet ready for primetime. Bug reports are welcome, but please don't file any feature requests or other missing things to be on par with Element Web.
Hydrogen's goals are:
- Work well on desktop as well as mobile browsers
- UI components can be easily used in isolation
- It is a standalone webapp, but can also be easily embedded into an existing website/webapp to add chat capabilities.
- Loading (unused) parts of the application after initial page load should be supported
For embedded usage, see the SDK instructions.
If you find this interesting, come and discuss on
How to use
Hydrogen is deployed to hydrogen.element.io. You can also deploy Hydrogen on your own web server:
- Download the latest release package.
- Extract the package to the public directory of your web server.
- If this is your first deploy:
config.jsonand if needed, make any modifications (unless you've set up your own sygnal instance, you don't need to change anything in the
Disable caching entirely on the server for:
- All theme manifests referenced in the
config.json, these files are typically called
These resources will still be cached client-side by the service worker. Because of this; you'll still need to refresh the app twice before config.json changes are applied.
Set up a dev environment
You can run Hydrogen locally by the following commands in the terminal:
yarn install(only the first time)
yarn startin the terminal
Now point your browser to
http://localhost:3000. If you prefer, you can also use docker.
Some frequently asked questions are answered here.