improve the getting started instructions and plug the electron apps

pull/1906/head
Matthew Hodgson 2016-07-28 16:05:03 +02:00
parent e34db7b8c6
commit fd53f10fbd
1 changed files with 27 additions and 4 deletions

View File

@ -6,9 +6,12 @@ Vector is a Matrix web client built using the Matrix React SDK (https://github.c
Getting Started Getting Started
=============== ===============
Vector is a modular webapp built with modern ES6 and requires and npm build system to build. The easiest way to test Vector is to just use the hosted copy at https://vector.im/beta.
Instructions for building are below, but building from source shouldn't be necessary The develop branch is continuously deployed by Jenkins at https://vector.im/develop for
for simple deployments. those who like living dangerously.
To host your own copy of Vector, the quickest bet is to use a pre-built released version
of Vector:
1. Download the latest version from https://vector.im/packages/ 1. Download the latest version from https://vector.im/packages/
1. Untar the tarball on your web server 1. Untar the tarball on your web server
@ -20,7 +23,7 @@ for simple deployments.
Building From Source Building From Source
==================== ====================
If you do wish to build vector from source: Vector is a modular webapp built with modern ES6 and requires a npm build system to build.
1. Install or update `node.js` so that your `npm` is at least at version `2.0.0` 1. Install or update `node.js` so that your `npm` is at least at version `2.0.0`
1. Clone the repo: `git clone https://github.com/vector-im/vector-web.git` 1. Clone the repo: `git clone https://github.com/vector-im/vector-web.git`
@ -53,6 +56,26 @@ You can configure the app by copying `vector/config.sample.json` to
registering with an email address or adding an email address to your account registering with an email address or adding an email address to your account
will not work. will not work.
Running as a Desktop app
========================
In future we'll do an official distribution of Vector as an desktop app. Meanwhile,
there are a few options:
@asdf:matrix.org points out that you can use nativefier and it just works(tm):
```
sudo npm install nativefier -g
nativefier https://vector.im/beta/
```
krisa has a dedicated electron project at https://github.com/krisak/vector-electron-desktop
(although you should swap out the 'vector' folder for the latest vector tarball you want to run)
There's also a (much) older electron distribution at https://github.com/stevenhammerton/vector-desktop
Development Development
=========== ===========