Hydrogen

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.

Goals

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 #hydrogen:matrix.org.

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:
1. copy config.sample.json to config.json and if needed, make any modifications (unless you've set up your own sygnal instance, you don't need to change anything in the push section).
2. Disable caching entirely on the server for:
  - index.html
  - sw.js
  - config.json
  - All theme manifests referenced in the themeManifests of config.json, these files are typically called theme-{name}.json.
  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 start in the terminal

Now point your browser to http://localhost:3000. If you prefer, you can also use docker.

PS: You need nodejs, running yarn on top of any other js platform is not supported.

FAQ

Some frequently asked questions are answered here.

Hydrogen

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.

Goals

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 #hydrogen:matrix.org.

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:
1. copy config.sample.json to config.json and if needed, make any modifications (unless you've set up your own sygnal instance, you don't need to change anything in the push section).
2. Disable caching entirely on the server for:
  - index.html
  - sw.js
  - config.json
  - All theme manifests referenced in the themeManifests of config.json, these files are typically called theme-{name}.json.
  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 start in the terminal

Now point your browser to http://localhost:3000. If you prefer, you can also use docker.

PS: You need nodejs, running yarn on top of any other js platform is not supported.

FAQ

Some frequently asked questions are answered here.

Hydrogen

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.

Goals

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 #hydrogen:matrix.org.

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:
1. copy config.sample.json to config.json and if needed, make any modifications (unless you've set up your own sygnal instance, you don't need to change anything in the push section).
2. Disable caching entirely on the server for:
  - index.html
  - sw.js
  - config.json
  - All theme manifests referenced in the themeManifests of config.json, these files are typically called theme-{name}.json.
  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 start in the terminal

Now point your browser to http://localhost:3000. If you prefer, you can also use docker.

PS: You need nodejs, running yarn on top of any other js platform is not supported.

FAQ

Some frequently asked questions are answered here.

Hydrogen

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.

Goals

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 #hydrogen:matrix.org.

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:
1. copy config.sample.json to config.json and if needed, make any modifications (unless you've set up your own sygnal instance, you don't need to change anything in the push section).
2. Disable caching entirely on the server for:
  - index.html
  - sw.js
  - config.json
  - All theme manifests referenced in the themeManifests of config.json, these files are typically called theme-{name}.json.
  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 start in the terminal

Now point your browser to http://localhost:3000. If you prefer, you can also use docker.

PS: You need nodejs, running yarn on top of any other js platform is not supported.

FAQ

Some frequently asked questions are answered here.

Hydrogen

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.

Goals

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 #hydrogen:matrix.org.

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:
1. copy config.sample.json to config.json and if needed, make any modifications (unless you've set up your own sygnal instance, you don't need to change anything in the push section).
2. Disable caching entirely on the server for:
  - index.html
  - sw.js
  - config.json
  - All theme manifests referenced in the themeManifests of config.json, these files are typically called theme-{name}.json.
  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 start in the terminal

Now point your browser to http://localhost:3000. If you prefer, you can also use docker.

PS: You need nodejs, running yarn on top of any other js platform is not supported.

FAQ

Some frequently asked questions are answered here.

Hydrogen

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.

Goals

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 #hydrogen:matrix.org.

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:
1. copy config.sample.json to config.json and if needed, make any modifications (unless you've set up your own sygnal instance, you don't need to change anything in the push section).
2. Disable caching entirely on the server for:
  - index.html
  - sw.js
  - config.json
  - All theme manifests referenced in the themeManifests of config.json, these files are typically called theme-{name}.json.
  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 start in the terminal

Now point your browser to http://localhost:3000. If you prefer, you can also use docker.

PS: You need nodejs, running yarn on top of any other js platform is not supported.

FAQ

Some frequently asked questions are answered here.

Hydrogen

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.

Goals

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 #hydrogen:matrix.org.

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:
1. copy config.sample.json to config.json and if needed, make any modifications (unless you've set up your own sygnal instance, you don't need to change anything in the push section).
2. Disable caching entirely on the server for:
  - index.html
  - sw.js
  - config.json
  - All theme manifests referenced in the themeManifests of config.json, these files are typically called theme-{name}.json.
  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 start in the terminal

Now point your browser to http://localhost:3000. If you prefer, you can also use docker.

PS: You need nodejs, running yarn on top of any other js platform is not supported.

FAQ

Some frequently asked questions are answered here.

Hydrogen

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.

Goals

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 #hydrogen:matrix.org.

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:
1. copy config.sample.json to config.json and if needed, make any modifications (unless you've set up your own sygnal instance, you don't need to change anything in the push section).
2. Disable caching entirely on the server for:
  - index.html
  - sw.js
  - config.json
  - All theme manifests referenced in the themeManifests of config.json, these files are typically called theme-{name}.json.
  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 start in the terminal

Now point your browser to http://localhost:3000. If you prefer, you can also use docker.

PS: You need nodejs, running yarn on top of any other js platform is not supported.

FAQ

Some frequently asked questions are answered here.

Name		Name	Last commit message	Last commit date
.github		.github
doc		doc
docker		docker
playwright		playwright
prototypes		prototypes
scripts		scripts
src		src
.dockerignore		.dockerignore
.editorconfig		.editorconfig
.eslintrc.js		.eslintrc.js
.gitignore		.gitignore
.gitlab-ci.yml		.gitlab-ci.yml
.ts-eslintrc.js		.ts-eslintrc.js
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
Dockerfile-dev		Dockerfile-dev
FAQ.md		FAQ.md
LICENSE		LICENSE
README.md		README.md
TODO.md		TODO.md
codestyle.md		codestyle.md
package.json		package.json
playwright.config.ts		playwright.config.ts
tsconfig-declaration.json		tsconfig-declaration.json
tsconfig.json		tsconfig.json
view-gallery.html		view-gallery.html
vite.common-config.js		vite.common-config.js
vite.config.js		vite.config.js
vite.sdk-assets-config.js		vite.sdk-assets-config.js
vite.sdk-lib-config.js		vite.sdk-lib-config.js
yarn.lock		yarn.lock

Name		Name	Last commit message	Last commit date
.github		.github
doc		doc
docker		docker
playwright		playwright
prototypes		prototypes
scripts		scripts
src		src
.dockerignore		.dockerignore
.editorconfig		.editorconfig
.eslintrc.js		.eslintrc.js
.gitignore		.gitignore
.gitlab-ci.yml		.gitlab-ci.yml
.ts-eslintrc.js		.ts-eslintrc.js
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
Dockerfile-dev		Dockerfile-dev
FAQ.md		FAQ.md
LICENSE		LICENSE
README.md		README.md
TODO.md		TODO.md
codestyle.md		codestyle.md
package.json		package.json
playwright.config.ts		playwright.config.ts
tsconfig-declaration.json		tsconfig-declaration.json
tsconfig.json		tsconfig.json
view-gallery.html		view-gallery.html
vite.common-config.js		vite.common-config.js
vite.config.js		vite.config.js
vite.sdk-assets-config.js		vite.sdk-assets-config.js
vite.sdk-lib-config.js		vite.sdk-lib-config.js
yarn.lock		yarn.lock

Name		Name	Last commit message	Last commit date
.github		.github
doc		doc
docker		docker
playwright		playwright
prototypes		prototypes
scripts		scripts
src		src
.dockerignore		.dockerignore
.editorconfig		.editorconfig
.eslintrc.js		.eslintrc.js
.gitignore		.gitignore
.gitlab-ci.yml		.gitlab-ci.yml
.ts-eslintrc.js		.ts-eslintrc.js
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
Dockerfile-dev		Dockerfile-dev
FAQ.md		FAQ.md
LICENSE		LICENSE
README.md		README.md
TODO.md		TODO.md
codestyle.md		codestyle.md
package.json		package.json
playwright.config.ts		playwright.config.ts
tsconfig-declaration.json		tsconfig-declaration.json
tsconfig.json		tsconfig.json
view-gallery.html		view-gallery.html
vite.common-config.js		vite.common-config.js
vite.config.js		vite.config.js
vite.sdk-assets-config.js		vite.sdk-assets-config.js
vite.sdk-lib-config.js		vite.sdk-lib-config.js
yarn.lock		yarn.lock

Name		Name	Last commit message	Last commit date
.github		.github
doc		doc
docker		docker
playwright		playwright
prototypes		prototypes
scripts		scripts
src		src
.dockerignore		.dockerignore
.editorconfig		.editorconfig
.eslintrc.js		.eslintrc.js
.gitignore		.gitignore
.gitlab-ci.yml		.gitlab-ci.yml
.ts-eslintrc.js		.ts-eslintrc.js
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
Dockerfile-dev		Dockerfile-dev
FAQ.md		FAQ.md
LICENSE		LICENSE
README.md		README.md
TODO.md		TODO.md
codestyle.md		codestyle.md
package.json		package.json
playwright.config.ts		playwright.config.ts
tsconfig-declaration.json		tsconfig-declaration.json
tsconfig.json		tsconfig.json
view-gallery.html		view-gallery.html
vite.common-config.js		vite.common-config.js
vite.config.js		vite.config.js
vite.sdk-assets-config.js		vite.sdk-assets-config.js
vite.sdk-lib-config.js		vite.sdk-lib-config.js
yarn.lock		yarn.lock

Name		Name	Last commit message	Last commit date
.github		.github
doc		doc
docker		docker
playwright		playwright
prototypes		prototypes
scripts		scripts
src		src
.dockerignore		.dockerignore
.editorconfig		.editorconfig
.eslintrc.js		.eslintrc.js
.gitignore		.gitignore
.gitlab-ci.yml		.gitlab-ci.yml
.ts-eslintrc.js		.ts-eslintrc.js
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
Dockerfile-dev		Dockerfile-dev
FAQ.md		FAQ.md
LICENSE		LICENSE
README.md		README.md
TODO.md		TODO.md
codestyle.md		codestyle.md
package.json		package.json
playwright.config.ts		playwright.config.ts
tsconfig-declaration.json		tsconfig-declaration.json
tsconfig.json		tsconfig.json
view-gallery.html		view-gallery.html
vite.common-config.js		vite.common-config.js
vite.config.js		vite.config.js
vite.sdk-assets-config.js		vite.sdk-assets-config.js
vite.sdk-lib-config.js		vite.sdk-lib-config.js
yarn.lock		yarn.lock

Latest commit

History

Folders and files

Repository files navigation

Hydrogen

Goals

How to use

Set up a dev environment

FAQ

About

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Hydrogen

Goals

How to use

Set up a dev environment

FAQ

About

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Hydrogen

Goals

How to use

Set up a dev environment

FAQ

About

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Hydrogen

Goals

How to use

Set up a dev environment

FAQ

About

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation