PrivateCoffee/element-web
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 3

Merge pull request #14581 from resynth1943/resynth1943-patch-riot-to-element

Browse source 
Riot → Element
This commit is contained in:
J. Ryan Stinnett 2020-07-21 10:46:31 +01:00 committed by GitHub
commit 6c50aa14ad
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
17 changed files with 121 additions and 121 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

66
README.md
View file

@ -1,41 +1,41 @@
Riot Element
==== =======
Riot (formerly known as Vector) is a Matrix web client built using the [Matrix Element (formerly known as Vector and Riot) is a Matrix web client built using the [Matrix
React SDK](https://github.com/matrix-org/matrix-react-sdk). React SDK](https://github.com/matrix-org/matrix-react-sdk).
Supported Environments Supported Environments
====================== ======================
Riot has several tiers of support for different environments: Element has several tiers of support for different environments:
* Supported * Supported
* Definition: Issues **actively triaged**, regressions **block** the release * Definition: Issues **actively triaged**, regressions **block** the release
* Last 2 major versions of Chrome, Firefox, and Safari on desktop OSes * Last 2 major versions of Chrome, Firefox, and Safari on desktop OSes
* Latest release of official Riot Desktop app on desktop OSes * Latest release of official Element Desktop app on desktop OSes
* Desktop OSes means macOS, Windows, and Linux versions for desktop devices * Desktop OSes means macOS, Windows, and Linux versions for desktop devices
that are actively supported by the OS vendor and receive security updates that are actively supported by the OS vendor and receive security updates
* Experimental * Experimental
* Definition: Issues **accepted**, regressions **do not block** the release * Definition: Issues **accepted**, regressions **do not block** the release
* Riot as an installed PWA via current stable version of Chrome, Firefox, and Safari * Element as an installed PWA via current stable version of Chrome, Firefox, and Safari
* Mobile web for current stable version of Chrome, Firefox, and Safari on Android, iOS, and iPadOS * Mobile web for current stable version of Chrome, Firefox, and Safari on Android, iOS, and iPadOS
* Not supported * Not supported
* Definition: Issues only affecting unsupported environments are **closed** * Definition: Issues only affecting unsupported environments are **closed**
* Everything else * Everything else
For accessing Riot on an Android or iOS device, we currently recommend the For accessing Element on an Android or iOS device, we currently recommend the
native apps [riot-android](https://github.com/vector-im/riot-android) native apps [riot-android](https://github.com/vector-im/riot-android)
and [riot-ios](https://github.com/vector-im/riot-ios). and [riot-ios](https://github.com/vector-im/riot-ios).
Getting Started Getting Started
=============== ===============
The easiest way to test Riot is to just use the hosted copy at https://riot.im/app. The easiest way to test Element is to just use the hosted copy at https://app.element.io.
The `develop` branch is continuously deployed by Jenkins at https://riot.im/develop The `develop` branch is continuously deployed by Jenkins at https://develop.element.io
for those who like living dangerously. for those who like living dangerously.
To host your own copy of Riot, the quickest bet is to use a pre-built To host your own copy of Element, the quickest bet is to use a pre-built
released version of Riot: released version of Element:
1. Download the latest version from https://github.com/vector-im/riot-web/releases 1. Download the latest version from https://github.com/vector-im/riot-web/releases
1. Untar the tarball on your web server 1. Untar the tarball on your web server
@ -43,29 +43,29 @@ released version of Riot:
1. Configure the correct caching headers in your webserver (see below) 1. Configure the correct caching headers in your webserver (see below)
1. If desired, copy `config.sample.json` to `config.json` and edit it 1. If desired, copy `config.sample.json` to `config.json` and edit it
as desired. See the [configuration docs](docs/config.md) for details. as desired. See the [configuration docs](docs/config.md) for details.
1. Enter the URL into your browser and log into Riot! 1. Enter the URL into your browser and log into Element!
Releases are signed using gpg and the OpenPGP standard, and can be checked against the public key located Releases are signed using gpg and the OpenPGP standard, and can be checked against the public key located
at https://packages.riot.im/riot-release-key.asc. at https://packages.riot.im/riot-release-key.asc.
Note that for the security of your chats will need to serve Riot Note that for the security of your chats will need to serve Element
over HTTPS. Major browsers also do not allow you to use VoIP/video over HTTPS. Major browsers also do not allow you to use VoIP/video
chats over HTTP, as WebRTC is only usable over HTTPS. chats over HTTP, as WebRTC is only usable over HTTPS.
There are some exceptions like when using localhost, which is There are some exceptions like when using localhost, which is
considered a [secure context](https://developer.mozilla.org/docs/Web/Security/Secure_Contexts) considered a [secure context](https://developer.mozilla.org/docs/Web/Security/Secure_Contexts)
and thus allowed. and thus allowed.
To install Riot as a desktop application, see [Running as a desktop To install Element as a desktop application, see [Running as a desktop
app](#running-as-a-desktop-app) below. app](#running-as-a-desktop-app) below.
Important Security Note Important Security Note
======================= =======================
We do not recommend running Riot from the same domain name as your Matrix We do not recommend running Element from the same domain name as your Matrix
homeserver. The reason is the risk of XSS (cross-site-scripting) homeserver. The reason is the risk of XSS (cross-site-scripting)
vulnerabilities that could occur if someone caused Riot to load and render vulnerabilities that could occur if someone caused Element to load and render
malicious user generated content from a Matrix API which then had trusted malicious user generated content from a Matrix API which then had trusted
access to Riot (or other apps) due to sharing the same domain. access to Element (or other apps) due to sharing the same domain.
We have put some coarse mitigations into place to try to protect against this We have put some coarse mitigations into place to try to protect against this
situation, but it's still not good practice to do it in the first place. See situation, but it's still not good practice to do it in the first place. See
@ -74,7 +74,7 @@ https://github.com/vector-im/riot-web/issues/1977 for more details.
Building From Source Building From Source
==================== ====================
Riot is a modular webapp built with modern ES6 and uses a Node.js build system. Element is a modular webapp built with modern ES6 and uses a Node.js build system.
Ensure you have the latest LTS version of Node.js installed. Ensure you have the latest LTS version of Node.js installed.
Using `yarn` instead of `npm` is recommended. Please see the Yarn [install Using `yarn` instead of `npm` is recommended. Please see the Yarn [install
@ -88,7 +88,7 @@ guide](https://classic.yarnpkg.com/en/docs/install) if you do not have it alread
* If you're using the `develop` branch, then it is recommended to set up a * If you're using the `develop` branch, then it is recommended to set up a
proper development environment (see [Setting up a dev proper development environment (see [Setting up a dev
environment](#setting-up-a-dev-environment) below). Alternatively, you environment](#setting-up-a-dev-environment) below). Alternatively, you
can use https://riot.im/develop - the continuous integration release of can use https://develop.element.io - the continuous integration release of
the develop branch. the develop branch.
1. Configure the app by copying `config.sample.json` to `config.json` and 1. Configure the app by copying `config.sample.json` to `config.json` and
modifying it. See the [configuration docs](docs/config.md) for details. modifying it. See the [configuration docs](docs/config.md) for details.
@ -97,14 +97,14 @@ guide](https://classic.yarnpkg.com/en/docs/install) if you do not have it alread
web server. web server.
Note that `yarn dist` is not supported on Windows, so Windows users can run `yarn build`, Note that `yarn dist` is not supported on Windows, so Windows users can run `yarn build`,
which will build all the necessary files into the `webapp` directory. The version of Riot which will build all the necessary files into the `webapp` directory. The version of Element
will not appear in Settings without using the dist script. You can then mount the will not appear in Settings without using the dist script. You can then mount the
`webapp` directory on your webserver to actually serve up the app, which is entirely static content. `webapp` directory on your webserver to actually serve up the app, which is entirely static content.
Running as a Desktop app Running as a Desktop app
======================== ========================
Riot can also be run as a desktop app, wrapped in Electron. You can download a Element can also be run as a desktop app, wrapped in Electron. You can download a
pre-built version from https://riot.im/download/desktop/ or, if you prefer, pre-built version from https://riot.im/download/desktop/ or, if you prefer,
build it yourself. build it yourself.
@ -117,7 +117,7 @@ Other options for running as a desktop app:
```bash ```bash
yarn global add nativefier yarn global add nativefier
nativefier https://riot.im/app/ nativefier https://app.element.io/
``` ```
The [configuration docs](docs/config.md#desktop-app-configuration) show how to The [configuration docs](docs/config.md#desktop-app-configuration) show how to
@ -162,19 +162,19 @@ docker build -t vectorim/riot-web:develop \
config.json config.json
=========== ===========
Riot supports a variety of settings to configure default servers, behaviour, themes, etc. Element supports a variety of settings to configure default servers, behaviour, themes, etc.
See the [configuration docs](docs/config.md) for more details. See the [configuration docs](docs/config.md) for more details.
Labs Features Labs Features
============= =============
Some features of Riot may be enabled by flags in the `Labs` section of the settings. Some features of Element may be enabled by flags in the `Labs` section of the settings.
Some of these features are described in [labs.md](https://github.com/vector-im/riot-web/blob/develop/docs/labs.md). Some of these features are described in [labs.md](https://github.com/vector-im/riot-web/blob/develop/docs/labs.md).
Caching requirements Caching requirements
==================== ====================
Riot requires the following URLs not to be cached, when/if you are serving Riot from your own webserver: Element requires the following URLs not to be cached, when/if you are serving Element from your own webserver:
``` ```
/config.*.json /config.*.json
/i18n /i18n
@ -188,7 +188,7 @@ Development
Before attempting to develop on Riot you **must** read the [developer guide Before attempting to develop on Riot you **must** read the [developer guide
for `matrix-react-sdk`](https://github.com/matrix-org/matrix-react-sdk#developer-guide), which for `matrix-react-sdk`](https://github.com/matrix-org/matrix-react-sdk#developer-guide), which
also defines the design, architecture and style for Riot too. also defines the design, architecture and style for Element too.
Before starting work on a feature, it's best to ensure your plan aligns well Before starting work on a feature, it's best to ensure your plan aligns well
with our vision for Riot. Please chat with the team in with our vision for Riot. Please chat with the team in
@ -199,7 +199,7 @@ You should also familiarise yourself with the ["Here be Dragons" guide
](https://docs.google.com/document/d/12jYzvkidrp1h7liEuLIe6BMdU0NUjndUYI971O06ooM) ](https://docs.google.com/document/d/12jYzvkidrp1h7liEuLIe6BMdU0NUjndUYI971O06ooM)
to the tame & not-so-tame dragons (gotchas) which exist in the codebase. to the tame & not-so-tame dragons (gotchas) which exist in the codebase.
The idea of Riot is to be a relatively lightweight "skin" of customisations on The idea of Element is to be a relatively lightweight "skin" of customisations on
top of the underlying `matrix-react-sdk`. `matrix-react-sdk` provides both the top of the underlying `matrix-react-sdk`. `matrix-react-sdk` provides both the
higher and lower level React components useful for building Matrix communication higher and lower level React components useful for building Matrix communication
apps using React. apps using React.
@ -207,15 +207,15 @@ apps using React.
After creating a new component you must run `yarn reskindex` to regenerate After creating a new component you must run `yarn reskindex` to regenerate
the `component-index.js` for the app (used in future for skinning). the `component-index.js` for the app (used in future for skinning).
Please note that Riot is intended to run correctly without access to the public Please note that Element is intended to run correctly without access to the public
internet. So please don't depend on resources (JS libs, CSS, images, fonts) internet. So please don't depend on resources (JS libs, CSS, images, fonts)
hosted by external CDNs or servers but instead please package all dependencies hosted by external CDNs or servers but instead please package all dependencies
into Riot itself. into Element itself.
Setting up a dev environment Setting up a dev environment
============================ ============================
Much of the functionality in Riot is actually in the `matrix-react-sdk` and Much of the functionality in Element is actually in the `matrix-react-sdk` and
`matrix-js-sdk` modules. It is possible to set these up in a way that makes it `matrix-js-sdk` modules. It is possible to set these up in a way that makes it
easy to track the `develop` branches in git and to make local changes without easy to track the `develop` branches in git and to make local changes without
having to manually rebuild each time. having to manually rebuild each time.
@ -243,7 +243,7 @@ yarn install
popd popd
``` ```
Finally, build and start Riot itself: Finally, build and start Element itself:
```bash ```bash
git clone https://github.com/vector-im/riot-web.git git clone https://github.com/vector-im/riot-web.git
@ -299,12 +299,12 @@ ___
When you make changes to `matrix-react-sdk` or `matrix-js-sdk` they should be When you make changes to `matrix-react-sdk` or `matrix-js-sdk` they should be
automatically picked up by webpack and built. automatically picked up by webpack and built.
If you add or remove any components from the Riot skin, you will need to rebuild If you add or remove any components from the Element skin, you will need to rebuild
the skin's index by running, `yarn reskindex`. the skin's index by running, `yarn reskindex`.
If any of these steps error with, `file table overflow`, you are probably on a mac If any of these steps error with, `file table overflow`, you are probably on a mac
which has a very low limit on max open files. Run `ulimit -Sn 1024` and try again. which has a very low limit on max open files. Run `ulimit -Sn 1024` and try again.
You'll need to do this in each new terminal you open before building Riot. You'll need to do this in each new terminal you open before building Element.
Running the tests Running the tests
----------------- -----------------

32
docs/config.md
View file

@ -4,13 +4,13 @@ Configuration
You can configure the app by copying `config.sample.json` to You can configure the app by copying `config.sample.json` to
`config.json` and customising it: `config.json` and customising it:
For a good example, see https://riot.im/develop/config.json. For a good example, see https;//develop.element.io/config.json.
1. `default_server_config` sets the default homeserver and identity server URL for 1. `default_server_config` sets the default homeserver and identity server URL for
Riot to use. The object is the same as returned by [https://<server_name>/.well-known/matrix/client](https://matrix.org/docs/spec/client_server/latest.html#get-well-known-matrix-client), Element to use. The object is the same as returned by [https://<server_name>/.well-known/matrix/client](https://matrix.org/docs/spec/client_server/latest.html#get-well-known-matrix-client),
with added support for a `server_name` under the `m.homeserver` section to display with added support for a `server_name` under the `m.homeserver` section to display
a custom homeserver name. Alternatively, the config can contain a `default_server_name` a custom homeserver name. Alternatively, the config can contain a `default_server_name`
instead which is where Riot will go to get that same object, although this option is instead which is where Element will go to get that same object, although this option is
deprecated - see the `.well-known` link above for more information on using this option. deprecated - see the `.well-known` link above for more information on using this option.
Note that the `default_server_name` is used to get a complete server configuration Note that the `default_server_name` is used to get a complete server configuration
whereas the `server_name` in the `default_server_config` is for display purposes only. whereas the `server_name` in the `default_server_config` is for display purposes only.
@ -18,10 +18,10 @@ For a good example, see https://riot.im/develop/config.json.
`default_is_url`, however these are deprecated. They are maintained for backwards `default_is_url`, however these are deprecated. They are maintained for backwards
compatibility with older configurations. `default_is_url` is respected only compatibility with older configurations. `default_is_url` is respected only
if `default_hs_url` is used. if `default_hs_url` is used.
* Riot will fail to load if a mix of `default_server_config`, `default_server_name`, or * Element will fail to load if a mix of `default_server_config`, `default_server_name`, or
`default_hs_url` is specified. When multiple sources are specified, it is unclear `default_hs_url` is specified. When multiple sources are specified, it is unclear
which should take priority and therefore the application cannot continue. which should take priority and therefore the application cannot continue.
* As of Riot 1.4.0, identity servers are optional. See [Identity servers](#identity-servers) below. * As of Element 1.4.0, identity servers are optional. See [Identity servers](#identity-servers) below.
1. `features`: Lookup of optional features that may be `enable`d, `disable`d, or 1. `features`: Lookup of optional features that may be `enable`d, `disable`d, or
exposed to the user in the `labs` section of settings. The available exposed to the user in the `labs` section of settings. The available
optional experimental features vary from release to release and are [documented](labs.md). The feature flag process is optional experimental features vary from release to release and are [documented](labs.md). The feature flag process is
@ -42,7 +42,7 @@ For a good example, see https://riot.im/develop/config.json.
1. `adminMessageMD`: An extra message to show on the reporting dialog to 1. `adminMessageMD`: An extra message to show on the reporting dialog to
mention homeserver-specific policies. Accepts Markdown. mention homeserver-specific policies. Accepts Markdown.
1. `integrations_ui_url`: URL to the web interface for the integrations server. The integrations 1. `integrations_ui_url`: URL to the web interface for the integrations server. The integrations
server is not Riot and normally not your homeserver either. The integration server settings server is not Element and normally not your homeserver either. The integration server settings
may be left blank to disable integrations. may be left blank to disable integrations.
1. `integrations_rest_url`: URL to the REST interface for the integrations server. 1. `integrations_rest_url`: URL to the REST interface for the integrations server.
1. `integrations_widgets_urls`: list of URLs to the REST interface for the widget integrations server. 1. `integrations_widgets_urls`: list of URLs to the REST interface for the widget integrations server.
@ -65,10 +65,10 @@ For a good example, see https://riot.im/develop/config.json.
1. `whitelistedISUrls`: a list of IS URLs to not redact from the analytics 1. `whitelistedISUrls`: a list of IS URLs to not redact from the analytics
1. `siteId`: The Piwik Site ID to use when sending analytics to the Piwik server configured above 1. `siteId`: The Piwik Site ID to use when sending analytics to the Piwik server configured above
1. `welcomeUserId`: the user ID of a bot to invite whenever users register that can give them a tour 1. `welcomeUserId`: the user ID of a bot to invite whenever users register that can give them a tour
1. `embeddedPages`: Configures the pages displayed in portions of Riot that 1. `embeddedPages`: Configures the pages displayed in portions of Element that
embed static files, such as: embed static files, such as:
1. `welcomeUrl`: Initial content shown on the outside of the app when not 1. `welcomeUrl`: Initial content shown on the outside of the app when not
logged in. Defaults to `welcome.html` supplied with Riot. logged in. Defaults to `welcome.html` supplied with Element.
1. `homeUrl`: Content shown on the inside of the app when a specific room is 1. `homeUrl`: Content shown on the inside of the app when a specific room is
not selected. By default, no home page is configured. If one is set, a not selected. By default, no home page is configured. If one is set, a
button to access it will be shown in the top left menu. button to access it will be shown in the top left menu.
@ -80,7 +80,7 @@ For a good example, see https://riot.im/develop/config.json.
is special cased to the `default_theme` in the config file). is special cased to the `default_theme` in the config file).
1. `disable_custom_urls`: disallow the user to change the 1. `disable_custom_urls`: disallow the user to change the
default homeserver when signing up or logging in. default homeserver when signing up or logging in.
1. `permalinkPrefix`: Used to change the URL that Riot generates permalinks with. 1. `permalinkPrefix`: Used to change the URL that Element generates permalinks with.
By default, this is "https://matrix.to" to generate matrix.to (spec) permalinks. By default, this is "https://matrix.to" to generate matrix.to (spec) permalinks.
Set this to your Riot instance URL if you run an unfederated server (eg: Set this to your Riot instance URL if you run an unfederated server (eg:
"https://riot.example.org"). "https://riot.example.org").
@ -103,14 +103,14 @@ For a good example, see https://riot.im/develop/config.json.
Defaults to true (room federation enabled). Defaults to true (room federation enabled).
Note that `index.html` also has an og:image meta tag that is set to an image Note that `index.html` also has an og:image meta tag that is set to an image
hosted on riot.im. This is the image used if links to your copy of Riot hosted on riot.im. This is the image used if links to your copy of Element
appear in some websites like Facebook, and indeed Riot itself. This has to be appear in some websites like Facebook, and indeed Element itself. This has to be
static in the HTML and an absolute URL (and HTTP rather than HTTPS), so it's static in the HTML and an absolute URL (and HTTP rather than HTTPS), so it's
not possible for this to be an option in config.json. If you'd like to change not possible for this to be an option in config.json. If you'd like to change
it, you can build Riot, but run it, you can build Element, but run
`RIOT_OG_IMAGE_URL="http://example.com/logo.png" yarn build`. `RIOT_OG_IMAGE_URL="http://example.com/logo.png" yarn build`.
Alternatively, you can edit the `og:image` meta tag in `index.html` directly Alternatively, you can edit the `og:image` meta tag in `index.html` directly
each time you download a new version of Riot. each time you download a new version of Element.
Identity servers Identity servers
================ ================
@ -119,10 +119,10 @@ The identity server is used for inviting other users to a room via third party
identifiers like emails and phone numbers. It is not used to store your password identifiers like emails and phone numbers. It is not used to store your password
or account information. or account information.
As of Riot 1.4.0, all identity server functions are optional and you are As of Element 1.4.0, all identity server functions are optional and you are
prompted to agree to terms before data is sent to the identity server. prompted to agree to terms before data is sent to the identity server.
Riot will check multiple sources when looking for an identity server to use in Element will check multiple sources when looking for an identity server to use in
the following order of preference: the following order of preference:
1. The identity server set in the user's account data 1. The identity server set in the user's account data
@ -132,7 +132,7 @@ the following order of preference:
login login
3. The identity server provided by the Riot config file 3. The identity server provided by the Riot config file
If none of these sources have an identity server set, then Riot will prompt the If none of these sources have an identity server set, then Element will prompt the
user to set an identity server first when attempting to use features that user to set an identity server first when attempting to use features that
require one. require one.

4
docs/e2ee.md
View file

@ -1,7 +1,7 @@
# End to end encryption by default # End to end encryption by default
By default, Riot will create encrypted DM rooms if the user you are chatting with has keys uploaded on their account. By default, Element will create encrypted DM rooms if the user you are chatting with has keys uploaded on their account.
For private room creation, Riot will default to encryption on but give you the choice to opt-out. For private room creation, Element will default to encryption on but give you the choice to opt-out.
## Disabling encryption by default ## Disabling encryption by default

4
docs/feature-flags.md
View file

@ -1,6 +1,6 @@
# Feature flags # Feature flags
When developing new features for Riot, we use feature flags to give us more When developing new features for Element, we use feature flags to give us more
flexibility and control over when and where those features are enabled. flexibility and control over when and where those features are enabled.
For example, flags make the following things possible: For example, flags make the following things possible:
@ -88,7 +88,7 @@ and
configs. configs.
**Warning:** While this does mean the feature is enabled by default for **Warning:** While this does mean the feature is enabled by default for
https://riot.im and official Riot Desktop builds, it will not be enabled by https://app.element.io and official Element Desktop builds, it will not be enabled by
default for self-hosted installs, custom desktop builds, etc. To cover those default for self-hosted installs, custom desktop builds, etc. To cover those
cases as well, the best options at the moment are converting to a regular cases as well, the best options at the moment are converting to a regular
setting defaulted on or to remove the flag. Simply enabling the existing flag by setting defaulted on or to remove the flag. Simply enabling the existing flag by

28
docs/jitsi-dev.md
View file

@ -1,10 +1,10 @@
# Jitsi wrapper developer docs # Jitsi wrapper developer docs
*If you're looking for information on how to set up Jitsi in your Riot, see *If you're looking for information on how to set up Jitsi in your Element, see
[jitsi.md](./jitsi.md) instead.* [jitsi.md](./jitsi.md) instead.*
These docs are for developers wondering how the different conference buttons work These docs are for developers wondering how the different conference buttons work
within Riot. If you're not a developer, you're probably looking for [jitsi.md](./jitsi.md). within Element. If you're not a developer, you're probably looking for [jitsi.md](./jitsi.md).
## Brief introduction to widgets ## Brief introduction to widgets
@ -17,8 +17,8 @@ in the react-sdk), though for some widgets special integration can be done. v2 w
have a `data` object which helps achieve that special integration, though v1 widgets have a `data` object which helps achieve that special integration, though v1 widgets
are best iframed and left alone. are best iframed and left alone.
Widgets have a `postMessage` API they can use to interact with Riot, which also allows Widgets have a `postMessage` API they can use to interact with Element, which also allows
Riot to interact with them. Typically this is most used by the sticker picker (an Element to interact with them. Typically this is most used by the sticker picker (an
account-level widget), though widgets like the Jitsi widget will request permissions to account-level widget), though widgets like the Jitsi widget will request permissions to
get 'stuck' into the room list during a conference. get 'stuck' into the room list during a conference.
@ -28,7 +28,7 @@ Widgets can be added with the `/addwidget <url>` command.
Integration managers (like Scalar and Dimension) are accessible via the 4 squares in Integration managers (like Scalar and Dimension) are accessible via the 4 squares in
the top right of the room and provide a simple UI over top of bridges, bots, and other the top right of the room and provide a simple UI over top of bridges, bots, and other
stuff to plug into a room. They are a separate service to Riot and are thus iframed stuff to plug into a room. They are a separate service to Element and are thus iframed
in a dialog as well. They also have a `postMessage` API they can use to interact with in a dialog as well. They also have a `postMessage` API they can use to interact with
the client to create things like widgets, give permissions to bridges, and generally the client to create things like widgets, give permissions to bridges, and generally
set everything up for the integration the user is working with. set everything up for the integration the user is working with.
@ -51,7 +51,7 @@ over `postMessage`, even if they aren't going to be using the widget APIs).
Widgets added with the `/addwidget` command will *not* be wrapped as they are not going Widgets added with the `/addwidget` command will *not* be wrapped as they are not going
through an integration manager. The widgets themselves *should* also work outside of through an integration manager. The widgets themselves *should* also work outside of
Riot. Widgets currently have a "pop out" button which opens them in a new tab and Element. Widgets currently have a "pop out" button which opens them in a new tab and
therefore have no connection back to Riot. therefore have no connection back to Riot.
## Jitsi widgets from integration managers ## Jitsi widgets from integration managers
@ -65,27 +65,27 @@ server they specified in their config.json - this is expected.
Some integration managers allow the user to change the conference name while others Some integration managers allow the user to change the conference name while others
will generate one for the user. will generate one for the user.
## Jitsi widgets generated by Riot itself ## Jitsi widgets generated by Element itself
When the user clicks on the call buttons by the composer, the integration manager is When the user clicks on the call buttons by the composer, the integration manager is
not involved in the slightest. Instead, Riot itself generates a widget event, this time not involved in the slightest. Instead, Element itself generates a widget event, this time
using the config.json parameters, and publishes that to the room. If there's only two using the config.json parameters, and publishes that to the room. If there's only two
people in the room, a plain WebRTC call is made instead of using a widget at all - these people in the room, a plain WebRTC call is made instead of using a widget at all - these
are defined in the Matrix specification. are defined in the Matrix specification.
The Jitsi widget created by Riot uses a local `jitsi.html` wrapper (or one hosted by The Jitsi widget created by Element uses a local `jitsi.html` wrapper (or one hosted by
`https://riot.im/app` for desktop users or those on non-https domains) as the widget `https://app.element.io` for desktop users or those on non-https domains) as the widget
`url`. The wrapper has some basic functionality for talking to Riot to ensure the `url`. The wrapper has some basic functionality for talking to Element to ensure the
required `postMessage` calls are fulfilled. required `postMessage` calls are fulfilled.
**Note**: Per [jitsi.md](./jitsi.md) the `preferredDomain` can also come from the server's **Note**: Per [jitsi.md](./jitsi.md) the `preferredDomain` can also come from the server's
client .well-known data. client .well-known data.
## The Jitsi wrapper in Riot ## The Jitsi wrapper in Element
Whenever Riot sees a Jitsi widget, it ditches the `url` and instead replaces it with Whenever Element sees a Jitsi widget, it ditches the `url` and instead replaces it with
its local wrapper, much like what it would do when creating a widget. However, instead its local wrapper, much like what it would do when creating a widget. However, instead
of using one from riot.im/app, it will use one local to the client instead. of using one from [app.element.io](https://app.element.io), it will use one local to the client instead.
The wrapper is used to provide a consistent experience to users, as well as being faster The wrapper is used to provide a consistent experience to users, as well as being faster
and less risky to load. The local wrapper URL is populated with the conference information and less risky to load. The local wrapper URL is populated with the conference information

18
docs/jitsi.md
View file

@ -1,6 +1,6 @@
# Jitsi in Riot # Jitsi in Element
Riot uses [Jitsi](https://jitsi.org/) for conference calls, which provides options for Element uses [Jitsi](https://jitsi.org/) for conference calls, which provides options for
self-hosting your own server and supports most major platforms. self-hosting your own server and supports most major platforms.
1:1 calls, or calls between you and one other person, do not use Jitsi. Instead, those 1:1 calls, or calls between you and one other person, do not use Jitsi. Instead, those
@ -14,13 +14,13 @@ will add a Jitsi widget which allows anyone in the room to join.
Integration managers (available through the 4 squares in the top right of the room) may Integration managers (available through the 4 squares in the top right of the room) may
provide their own approaches for adding Jitsi widgets. provide their own approaches for adding Jitsi widgets.
## Configuring Riot to use your self-hosted Jitsi server ## Configuring Element to use your self-hosted Jitsi server
Riot will use the Jitsi server that is embedded in the widget, even if it is not the Element will use the Jitsi server that is embedded in the widget, even if it is not the
one you configured. This is because conference calls must be held on a single Jitsi one you configured. This is because conference calls must be held on a single Jitsi
server and cannot be split over multiple servers. server and cannot be split over multiple servers.
However, you can configure Riot to *start* a conference with your Jitsi server by adding However, you can configure Element to *start* a conference with your Jitsi server by adding
to your [config](./config.md) the following: to your [config](./config.md) the following:
```json ```json
{ {
@ -30,13 +30,13 @@ to your [config](./config.md) the following:
} }
``` ```
The default is `jitsi.riot.im` (a free service offered by Riot), and the demo site for The default is `jitsi.riot.im` (a free service offered by Element), and the demo site for
Jitsi uses `meet.jit.si` (also free). Jitsi uses `meet.jit.si` (also free).
Once you've applied the config change, refresh Riot and press the call button. This Once you've applied the config change, refresh Element and press the call button. This
should start a new conference on your Jitsi server. should start a new conference on your Jitsi server.
**Note**: The widget URL will point to a `jitsi.html` page hosted by Riot. The Jitsi **Note**: The widget URL will point to a `jitsi.html` page hosted by Element. The Jitsi
domain will appear later in the URL as a configuration parameter. domain will appear later in the URL as a configuration parameter.
**Hint**: If you want everyone on your homeserver to use the same Jitsi server by **Hint**: If you want everyone on your homeserver to use the same Jitsi server by
@ -52,7 +52,7 @@ default, and you are using riot-web 1.6 or newer, set the following on your home
## Mobile app support ## Mobile app support
Currently the Riot mobile apps do not support custom Jitsi servers and will instead Currently the Element mobile apps do not support custom Jitsi servers and will instead
use the default `jitsi.riot.im` server. When users on the mobile apps join the call, use the default `jitsi.riot.im` server. When users on the mobile apps join the call,
they will be joining a different conference which has the same name, but not the same they will be joining a different conference which has the same name, but not the same
participants. This is a known bug and which needs to be fixed. participants. This is a known bug and which needs to be fixed.

14
docs/labs.md
View file

@ -1,8 +1,8 @@
# Labs features # Labs features
If Labs is enabled in the [Riot config](config.md), you can enable some of these features by going If Labs is enabled in the [Element config](config.md), you can enable some of these features by going
to `Settings->Labs`. This list is non-exhaustive and subject to change, chat in to `Settings->Labs`. This list is non-exhaustive and subject to change, chat in
[#riot-web:matrix.org](https://matrix.to/#/#riot-web:matrix.org) for more information. [#element-web:matrix.org](https://matrix.to/#/#element-web:matrix.org) for more information.
**Be warned! Labs features are not finalised, they may be fragile, they may change, they may be **Be warned! Labs features are not finalised, they may be fragile, they may change, they may be
dropped. Ask in the room if you are unclear about any details here.** dropped. Ask in the room if you are unclear about any details here.**
@ -26,7 +26,7 @@ your avatar next to the message composer.
An experimental approach for dealing with custom tags. Custom tags will appear in the bottom portion An experimental approach for dealing with custom tags. Custom tags will appear in the bottom portion
of the community filter panel. of the community filter panel.
Setting custom tags is not supported by Riot. Setting custom tags is not supported by Element.
## Render simple counters in room header (`feature_state_counters`) ## Render simple counters in room header (`feature_state_counters`)
@ -53,7 +53,7 @@ That's it. Now should see your new counter under the header.
## Multiple integration managers (`feature_many_integration_managers`) ## Multiple integration managers (`feature_many_integration_managers`)
Exposes a way to access all the integration managers known to Riot. This is an implementation of [MSC1957](https://github.com/matrix-org/matrix-doc/pull/1957). Exposes a way to access all the integration managers known to Element. This is an implementation of [MSC1957](https://github.com/matrix-org/matrix-doc/pull/1957).
## New ways to ignore people (`feature_mjolnir`) ## New ways to ignore people (`feature_mjolnir`)
@ -88,9 +88,9 @@ person is online.
## Custom themes (`feature_custom_themes`) ## Custom themes (`feature_custom_themes`)
Custom themes are possible through Riot's [theme support](./theming.md), though Custom themes are possible through Element's [theme support](./theming.md), though
normally these themes need to be defined in the config for Riot. This labs flag normally these themes need to be defined in the config for Element. This labs flag
adds an ability for end users to add themes themselves by using a URL to the JSON adds an ability for end users to add themes themselves by using a URL to the JSON
theme definition. theme definition.
For some sample themes, check out [aaronraimist/riot-web-themes](https://github.com/aaronraimist/riot-web-themes). For some sample themes, check out [aaronraimist/element-themes](https://github.com/aaronraimist/element-themes).

10
docs/memory-profiles-and-leaks.md
View file

@ -1,6 +1,6 @@
## Memory leaks ## Memory leaks
Riot usually emits slow behaviour just before it is about to crash. Getting a Element usually emits slow behaviour just before it is about to crash. Getting a
memory snapshot (below) just before that happens is ideal in figuring out what memory snapshot (below) just before that happens is ideal in figuring out what
is going wrong. is going wrong.
@ -14,14 +14,14 @@ this happens though so we can try and narrow down what might have gone wrong.
## Memory profiles/snapshots ## Memory profiles/snapshots
When investigating memory leaks/problems it's usually important to compare snapshots When investigating memory leaks/problems it's usually important to compare snapshots
from different points in the Riot session lifecycle. Most importantly, a snapshot from different points in the Element session lifecycle. Most importantly, a snapshot
to establish the baseline or "normal" memory usage is useful. Taking a snapshot to establish the baseline or "normal" memory usage is useful. Taking a snapshot
roughly 30-60 minutes after starting Riot is a good time to establish "normal" roughly 30-60 minutes after starting Element is a good time to establish "normal"
memory usage for the app - anything after that is at risk of hiding the memory leak memory usage for the app - anything after that is at risk of hiding the memory leak
and anything newer is still in the warmup stages of the app. and anything newer is still in the warmup stages of the app.
**Memory profiles can contain sensitive information.** If you are submitting a memory **Memory profiles can contain sensitive information.** If you are submitting a memory
profile to us for debugging purposes, please pick the appropriate Riot developer and profile to us for debugging purposes, please pick the appropriate Element developer and
send them over an encrypted private message. *Do not share your memory profile in send them over an encrypted private message. *Do not share your memory profile in
public channels or with people you do not trust.* public channels or with people you do not trust.*
@ -42,7 +42,7 @@ While the profile is in progress, the tab might be frozen or unresponsive.
1. Press CTRL+SHIFT+I (I as in eye). 1. Press CTRL+SHIFT+I (I as in eye).
2. Click the Memory tab. 2. Click the Memory tab.
3. Select "Heap Snapshot" and the riot.im VM instance (not the indexeddb one). 3. Select "Heap Snapshot" and the app.element.io VM instance (not the indexeddb one).
4. Click "Take Snapshot". 4. Click "Take Snapshot".
5. Wait a bit (coffee is a good option). 5. Wait a bit (coffee is a good option).
6. When the save button appears on the left side of the panel, click it to save the 6. When the save button appears on the left side of the panel, click it to save the

14
docs/native-node-modules.md
View file

@ -1,24 +1,24 @@
# Native Node Modules # Native Node Modules
For some features, the desktop version of Riot can make use of native Node For some features, the desktop version of Element can make use of native Node
modules. These allow Riot to integrate with the desktop in ways that a browser modules. These allow Riot to integrate with the desktop in ways that a browser
cannot. cannot.
While native modules enable powerful new features, they must be complied for While native modules enable powerful new features, they must be complied for
each operating system. For official Riot releases, we will always build these each operating system. For official Element releases, we will always build these
modules from source to ensure we can trust the compiled output. In the future, modules from source to ensure we can trust the compiled output. In the future,
we may offer a pre-compiled path for those who want to use these features in a we may offer a pre-compiled path for those who want to use these features in a
custom build of Riot without installing the various build tools required. custom build of Element without installing the various build tools required.
Do note that compiling a module for a particular operating system Do note that compiling a module for a particular operating system
(Linux/macOS/Windows) will need to be done on that operating system. (Linux/macOS/Windows) will need to be done on that operating system.
Cross-compiling from a host OS for a different target OS may be possible, but Cross-compiling from a host OS for a different target OS may be possible, but
we don't support this flow with Riot dependencies at this time. we don't support this flow with Element dependencies at this time.
At the moment, we need to make some changes to the Riot release process before At the moment, we need to make some changes to the Element release process before
we can support native Node modules at release time, so these features are we can support native Node modules at release time, so these features are
currently disabled by default until that is resolved. The following sections currently disabled by default until that is resolved. The following sections
explain the manual steps you can use with a custom build of Riot to enable explain the manual steps you can use with a custom build of Element to enable
these features if you'd like to try them out. these features if you'd like to try them out.
## Adding Seshat for search in E2E encrypted rooms ## Adding Seshat for search in E2E encrypted rooms
@ -53,7 +53,7 @@ Please make sure to include all the `--` as well as the `--release` command line
switch at the end. Modify your electron version accordingly depending on the switch at the end. Modify your electron version accordingly depending on the
version that is installed on your system. version that is installed on your system.
After this is done the Electron version of Riot can be run from the main folder After this is done the Electron version of Element can be run from the main folder
as usual using: as usual using:
yarn electron yarn electron

10
docs/review.md
View file

@ -1,7 +1,7 @@
# Review Guidelines # Review Guidelines
The following summarises review guidelines that we follow for pull requests in The following summarises review guidelines that we follow for pull requests in
Riot Web and other supporting repos. These are just guidelines (not strict Element Web and other supporting repos. These are just guidelines (not strict
rules) and may be updated over time. rules) and may be updated over time.
## Code Review ## Code Review
@ -58,7 +58,7 @@ When reviewing code, here are some things we look for and also things we avoid:
## Design and Product Review ## Design and Product Review
We want to ensure that all changes to Riot fit with our design and product We want to ensure that all changes to Element fit with our design and product
vision. We often request review from those teams so they can provide their vision. We often request review from those teams so they can provide their
perspective. perspective.
@ -72,11 +72,11 @@ functionality is:
As it can be difficult to review design work from looking at just the changed As it can be difficult to review design work from looking at just the changed
files in a PR, authors should be prepared for Design and / or Product teams to files in a PR, authors should be prepared for Design and / or Product teams to
request a link to an ad-hoc build of Riot (hosted anywhere) that can be used for request a link to an ad-hoc build of Element (hosted anywhere) that can be used for
the review. In the future, we [hope to automate the review. In the future, we [hope to automate
this](https://github.com/vector-im/riot-web/issues/12624) for every PR. this](https://github.com/vector-im/riot-web/issues/12624) for every PR.
Before starting work on a feature, it's best to ensure your plan aligns well Before starting work on a feature, it's best to ensure your plan aligns well
with our vision for Riot. Please chat with the team in with our vision for Element. Please chat with the team in
[#riot-dev:matrix.org](https://matrix.to/#/#riot-dev:matrix.org) before you [#element-dev:matrix.org](https://matrix.to/#/#element-dev:matrix.org) before you
start so we can ensure it's something we'd be willing to merge. start so we can ensure it's something we'd be willing to merge.

14
docs/skinning thoughts.md
View file

@ -5,14 +5,14 @@ matrix-react-sdk
- base CSS - base CSS
- all the components needed to build a workable app (including the top layer) - all the components needed to build a workable app (including the top layer)
riot-web: the riot skin element-web: the Element skin
- riot-specific classes (e.g. login header/footer) - Element-specific classes (e.g. login header/footer)
- riot-specific themes - Element-specific themes
- light - light
- dark - dark
i.e. the only things which should go into riot-web are bits which apply vector-specific skinning i.e. the only things which should go into element-web are bits which apply vector-specific skinning
specifically "Stuff that any other brand would not want to use. (e.g. riot logos, links, T&Cs)" specifically "Stuff that any other brand would not want to use. (e.g. Element logos, links, T&Cs)"
- Questions: - Questions:
- Electron app? (should probably be a separate repo in its own right? but might as well go here for now) - Electron app? (should probably be a separate repo in its own right? but might as well go here for now)
- index.html & index.js? (should be in matrix-react-sdk, given the SDK is useless without them?) - index.html & index.js? (should be in matrix-react-sdk, given the SDK is useless without them?)
@ -21,7 +21,7 @@ ideally matrix-react-sdk itself should ship with a default skin which actually w
status skin (can go in the same app for now) status skin (can go in the same app for now)
- has status theme - has status theme
- which inherits from riot light theme - which inherits from Element light theme
- how do we share graphics between skins? - how do we share graphics between skins?
- shove them into react-sdk, or... - shove them into react-sdk, or...
- guess we do ../../vector/img - guess we do ../../vector/img
@ -64,5 +64,5 @@ random thoughts;
----------------- -----------------
Immediate plan for Status: Immediate plan for Status:
* Implement it as a theme for the riot skin * Implement it as a theme for the Element skin
* Ideally move skins to a sensible level (possibly even including src?) * Ideally move skins to a sensible level (possibly even including src?)

10
docs/theming.md
View file

@ -1,14 +1,14 @@
Theming Riot Theming Element
============ ============
Themes are a very basic way of providing simple alternative look & feels to the Themes are a very basic way of providing simple alternative look & feels to the
riot-web app via CSS & custom imagery. Element app via CSS & custom imagery.
They are *NOT* co be confused with 'skins', which describe apps which sit on top They are *NOT* co be confused with 'skins', which describe apps which sit on top
of matrix-react-sdk - e.g. in theory Riot itself is a react-sdk skin. of matrix-react-sdk - e.g. in theory Element itself is a react-sdk skin.
As of Jan 2017, skins are not fully supported; riot is the only available skin. As of Jan 2017, skins are not fully supported; Element is the only available skin.
To define a theme for Riot: To define a theme for Element:
1. Pick a name, e.g. `teal`. at time of writing we have `light` and `dark`. 1. Pick a name, e.g. `teal`. at time of writing we have `light` and `dark`.
2. Fork `src/skins/vector/css/themes/dark.scss` to be `teal.scss` 2. Fork `src/skins/vector/css/themes/dark.scss` to be `teal.scss`

4
docs/translating-dev.md
View file

@ -1,4 +1,4 @@
# How to translate riot-web (Dev Guide) # How to translate Element (Dev Guide)
## Requirements ## Requirements
@ -6,7 +6,7 @@
- Including up-to-date versions of matrix-react-sdk and matrix-js-sdk - Including up-to-date versions of matrix-react-sdk and matrix-js-sdk
- Latest LTS version of Node.js installed - Latest LTS version of Node.js installed
- Be able to understand English - Be able to understand English
- Be able to understand the language you want to translate riot-web into - Be able to understand the language you want to translate Element into
## Translating strings vs. marking strings for translation ## Translating strings vs. marking strings for translation

8
docs/translating.md
View file

@ -1,10 +1,10 @@
# How to translate riot-web # How to translate Element
## Requirements ## Requirements
- Web Browser - Web Browser
- Be able to understand English - Be able to understand English
- Be able to understand the language you want to translate riot-web into - Be able to understand the language you want to translate Element into
## Step 0: Join #riotweb-translations:matrix.org ## Step 0: Join #riotweb-translations:matrix.org
@ -17,7 +17,7 @@
2. After registering check if you got an email to verify your account and click the link (if there is none head to step 1.4) 2. After registering check if you got an email to verify your account and click the link (if there is none head to step 1.4)
3. Log into weblate 3. Log into weblate
4. Head to https://translate.riot.im/accounts/profile/ and select the languages you know and maybe another language you know too. 4. Head to https://translate.riot.im/accounts/profile/ and select the languages you know and maybe another language you know too.
6. Head to https://translate.riot.im/accounts/profile/#subscriptions and select Riot Web as Project 6. Head to https://translate.riot.im/accounts/profile/#subscriptions and select Element Web as Project
## How to check if your language already is being translated ## How to check if your language already is being translated
@ -50,7 +50,7 @@ The yellow button has to be used if you are unsure about the translation but you
### What are "%(something)s"? ### What are "%(something)s"?
These things are variables that are expanded when displayed by Riot. They can be room names, usernames or similar. If you find one, you can move to the right place for your language, but not delete it as the variable will be missing if you do. These things are variables that are expanded when displayed by Element. They can be room names, usernames or similar. If you find one, you can move to the right place for your language, but not delete it as the variable will be missing if you do.
A special case is `%(urlStart)s` and `%(urlEnd)s` which are used to mark the beginning of a hyperlink (i.e. `<a href="/somewhere">` and `</a>`. You must keep these markers surrounding the equivalent string in your language that needs to be hyperlinked. A special case is `%(urlStart)s` and `%(urlEnd)s` which are used to mark the beginning of a hyperlink (i.e. `<a href="/somewhere">` and `</a>`. You must keep these markers surrounding the equivalent string in your language that needs to be hyperlinked.

2
release.sh
View file

@ -1,6 +1,6 @@
#!/bin/bash #!/bin/bash
# #
# Script to perform a release of riot-web. # Script to perform a release of element-web.
# #
# Requires github-changelog-generator; to install, do # Requires github-changelog-generator; to install, do
# pip install git+https://github.com/matrix-org/github-changelog-generator.git # pip install git+https://github.com/matrix-org/github-changelog-generator.git

2
scripts/ci_package.sh
View file

@ -1,6 +1,6 @@
#!/bin/bash #!/bin/bash
# Runs package.sh setting the version to git hashes of the riot-web, # Runs package.sh setting the version to git hashes of the element-web,
# react-sdk & js-sdk checkouts, for the case where these dependencies # react-sdk & js-sdk checkouts, for the case where these dependencies
# are git checkouts. # are git checkouts.

2
scripts/docker-link-repos.sh
View file

@ -34,6 +34,6 @@ yarn link matrix-js-sdk
yarn --network-timeout=100000 install yarn --network-timeout=100000 install
cd ../ cd ../
echo "Setting up riot-web with react-sdk and js-sdk packages" echo "Setting up element-web with react-sdk and js-sdk packages"
yarn link matrix-js-sdk yarn link matrix-js-sdk
yarn link matrix-react-sdk yarn link matrix-react-sdk