hydrogen-web/README.md

# Hydrogen

A minimal [Matrix](https://matrix.org/) 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](doc/SDK.md).

If you find this interesting, come and discuss on [`#hydrogen:matrix.org`](https://matrix.to/#/#hydrogen:matrix.org).

# How to use

Hydrogen is deployed to [hydrogen.element.io](https://hydrogen.element.io). You can also deploy Hydrogen on your own web server:

 1. Download the [latest release package](https://github.com/vector-im/hydrogen-web/releases).
 1. Extract the package to the public directory of your web server.
 1. 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](https://github.com/matrix-org/sygnal) instance, you don't need to change anything in the `push` section).
    1. Disable caching entirely on the server (they will still be cached client-side by the service worker) 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`.
 
## 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](doc/docker.md).

# FAQ

Some frequently asked questions are answered [here](doc/FAQ.md).
Update README.md rename to hydrogen 2020-08-04 20:26:19 +05:30			`# Hydrogen`
update README 2019-09-08 14:22:06 +05:30
Update README.md 2020-09-29 20:51:01 +05:30			`A minimal [Matrix](https://matrix.org/) 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.`
Create README.md 2019-01-09 15:40:33 +05:30
WIP 2020-08-05 22:47:35 +05:30			`## 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`

add deployment instruction now that we have a config file 2022-05-19 00:14:04 +05:30			`For embedded usage, see the [SDK instructions](doc/SDK.md).`

Add Hyperlink matrix.to to room 2020-12-05 14:46:37 +05:30			If you find this interesting, come and discuss on [`#hydrogen:matrix.org`](https://matrix.to/#/#hydrogen:matrix.org).
add usage instructions 2019-09-08 15:24:18 +05:30
			`# How to use`

add deployment instruction now that we have a config file 2022-05-19 00:14:04 +05:30			`Hydrogen is deployed to [hydrogen.element.io](https://hydrogen.element.io). You can also deploy Hydrogen on your own web server:`

			`1. Download the [latest release package](https://github.com/vector-im/hydrogen-web/releases).`
			`1. Extract the package to the public directory of your web server.`
			`1. If this is your first deploy:`
explain that push section of config usually doesn't need to be touched 2022-05-19 00:21:50 +05:30			1. copy `config.sample.json` to `config.json` and if needed, make any modifications (unless you've set up your own [sygnal](https://github.com/matrix-org/sygnal) instance, you don't need to change anything in the `push` section).
add deployment instruction now that we have a config file 2022-05-19 00:14:04 +05:30			`1. Disable caching entirely on the server (they will still be cached client-side by the service worker) 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`.

			`## 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
add FAQ 2021-01-25 15:05:13 +05:30
add deployment instruction now that we have a config file 2022-05-19 00:14:04 +05:30			Now point your browser to `http://localhost:3000`. If you prefer, you can also [use docker](doc/docker.md).
update readme 2021-03-26 22:52:17 +05:30
add FAQ 2021-01-25 15:05:13 +05:30			`# FAQ`

Fix typo 2021-02-08 18:51:13 +05:30			`Some frequently asked questions are answered [here](doc/FAQ.md).`