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
2021-01-29 09:45:26 +00:00
This project is still in its 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 ).
2021-01-29 09:45:26 +00:00
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
```
2021-01-29 09:45:26 +00:00
### Go inside web-service container and serve
2020-06-04 14:23:46 +00:00
```
docker-compose exec web /bin/bash
```
then
```
yarn serve
```
2021-01-29 09:45:26 +00:00
## Project setup for vscode and docker (developing inside dev container) on Linux
2020-06-04 09:02:46 +00:00
2021-01-29 10:22:22 +00:00
The goal is to have a complete dev environment very quickly and isolated.
2020-06-04 09:02:46 +00:00
### Install missing tools if needed
2021-01-29 09:45:26 +00:00
Follow [getting started ](https://code.visualstudio.com/docs/remote/containers#_getting-started ) section.
2020-06-04 09:02:46 +00:00
### 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
```
2021-01-29 09:45:26 +00:00
You now have useful vscode extensions, git support, your command history of the project.