The HOOBS™ development environment is designed to be ran on Debian Linux. The build routine uses Docker. This can be ran in a VM and using Visual Studio Code with the Remote SSH extension.
Prerequisites
- Debian Linux
- Visual Studio Code
- Make, GCC, GIT and Python
- Node and Yarn
- Sudo
Download the Code
Now you are ready to get the HOOBS™ code on you new development computer.
First clone the main HOOBS™ repository.
git clone https://github.com/hoobs-org/HOOBS.git
Now switch to the development branch.
cd HOOBS && git checkout blackwing
Now you are ready to setup the modules.
./project setup
Environment Variables
In the GUI project you will need to make a .env.development
file.
VUE_APP_API=http://127.0.0.1:50826
VUE_APP_SOCKET=http://127.0.0.1:50826
This tells the GUI where HOOBSD is. In production this is on the same host and port, but in development, it is on a different port so the API and SOCKET variables need to be set.
Development Server
Now you have the code, you are ready to run the development server.
You will need two TTYs to run the code. One for the server and one for the UI.
./project debug hoobsd
and
./project debug gui
VS Codes terminal makes this easy, just start or split a new terminal.