2020-05-04 04:31:12 +00:00
# frequi
2020-08-31 15:52:06 +00:00
![FreqUI CI ](https://github.com/freqtrade/frequi/workflows/FreqUI%20CI/badge.svg )
2020-05-14 09:11:57 +00:00
Freqtrade UI build with [Vue.js ](https://vuejs.org/ ) and [boostrap-vue ](https://bootstrap-vue.org/ ).
## WARNING
2020-06-04 10:05:58 +00:00
This project is still in it's early stages (consider it early-alpha), and is not yet stable nor recommended to be used for production usages.
2020-05-14 09:11:57 +00:00
2020-11-29 18:49:30 +00:00
It will require [freqtrade ](https://github.com/freqtrade/freqtrade ) to be running on the same host with the API enabled under (`localhost:8081`). You can either use the webpack proxy (port can be changed in `vue.config.js` ) - or connect directly to the API (recommended).
FOr this, you will also have to have CORS configured correctly [freqtrade documentation ](https://www.freqtrade.io/en/latest/rest-api/#cors ).
Most likely, the correct entry will be `http://localhost:8080` or `http://127.0.0.1:8080` - but the URL must match the url you use to access FreqUI.
Ports can vary, so check the url you're using.
2020-05-14 09:11:57 +00:00
2020-06-04 09:02:46 +00:00
## Project setup with node install locally
2020-05-14 09:11:57 +00:00
2020-06-04 09:02:46 +00:00
### Project setup
2020-05-18 18:49:30 +00:00
2020-05-04 04:31:12 +00:00
```
2020-06-05 09:22:14 +00:00
yarn install
2020-05-04 04:31:12 +00:00
```
### Compiles and hot-reloads for development
2020-05-18 18:49:30 +00:00
2020-05-04 04:31:12 +00:00
```
2020-06-05 09:22:14 +00:00
yarn serve
2020-05-04 04:31:12 +00:00
```
### Compiles and minifies for production
2020-05-18 18:49:30 +00:00
2020-05-04 04:31:12 +00:00
```
2020-06-05 09:22:14 +00:00
yarn build
2020-05-04 04:31:12 +00:00
```
### Lints and fixes files
2020-05-18 18:49:30 +00:00
2020-05-04 04:31:12 +00:00
```
2020-06-05 09:22:14 +00:00
yarn lint
2020-05-04 04:31:12 +00:00
```
2020-06-04 10:05:58 +00:00
### Build and run docker version
```
docker-compose build
docker-compose up -d
# Access using http://localhost:8080/
```
2020-05-04 04:31:12 +00:00
### Customize configuration
2020-11-29 18:49:30 +00:00
2020-05-04 04:31:12 +00:00
See [Configuration Reference ](https://cli.vuejs.org/config/ ).
2020-06-04 09:02:46 +00:00
2020-06-04 14:23:46 +00:00
## Project setup for docker (developing inside dev container) without vscode
### Built dev docker image and run container(s) detached
```
cd .devcontainer
docker-compose up -d
```
### Go inside web service container and serve
```
docker-compose exec web /bin/bash
```
then
```
yarn serve
```
2020-06-04 12:20:41 +00:00
## Project setup for vscode and docker (developing inside dev container) on linux
2020-06-04 09:02:46 +00:00
The goal is it have a complete dev environment very quickly and isolated.
### Install missing tools if needed
Follow [getting strated ](https://code.visualstudio.com/docs/remote/containers#_getting-started ) section.
### Build your dev container
View > Command palette > Enter: Remote-Containers rebuild container
2020-06-04 14:23:46 +00:00
### Serve your local server
2020-06-04 09:02:46 +00:00
```
yarn serve
```
2020-06-05 09:22:14 +00:00
You now have useful vscode extentions, git support, your command history of the project.