dispatch/README.md
Ken-Håvard Lieng 35f806c18d Update readme
2016-01-18 03:13:52 +01:00

85 lines
1.7 KiB
Markdown

# dispatch [![Build Status](https://travis-ci.org/khlieng/dispatch.svg?branch=master)](https://travis-ci.org/khlieng/dispatch)
####[Try it!](https://dispatch.khlieng.com)
### Features
* Searchable history
* Persistent connections
* Multiple servers and users
* Automatic HTTPS through Let's Encrypt
* Client certificates
## Usage
There is a few different ways of getting it:
#### 1. Binary
There will be binary releases.
#### 2. Go
This requires a [Go environment](http://golang.org/doc/install).
```bash
go get github.com/khlieng/dispatch
dispatch
```
To get some help run:
```bash
dispatch help
```
#### 3. Docker
```bash
docker run -p <http port>:80 -p <https port>:443 -v <path>:/data khlieng/dispatch
```
## Build
### Server
```bash
cd $GOPATH/src/github.com/khlieng/dispatch
go install
```
### Client
This requires [Node.js](https://nodejs.org/download/).
Fetch the dependencies:
```bash
npm install -g gulp
go get github.com/jteeuwen/go-bindata/...
cd $GOPATH/src/github.com/khlieng/dispatch/client
npm install
```
Run the build:
```bash
gulp build
```
The server needs to be rebuilt after this.
For development with hot reloading enabled just run:
```bash
gulp
```
## Libraries
The libraries this project is built with.
### Server
- [Bolt](https://github.com/boltdb/bolt)
- [Bleve](https://github.com/blevesearch/bleve)
- [Cobra](https://github.com/spf13/cobra)
- [Viper](https://github.com/spf13/viper)
- [Lego](https://github.com/xenolf/lego)
### Client
- [React](https://github.com/facebook/react)
- [Redux](https://github.com/rackt/redux)
- [React Router](https://github.com/rackt/react-router)
- [Immutable](https://github.com/facebook/immutable-js)
- [Lodash](https://github.com/lodash/lodash)