HestiaLabs Experiences

This repo currently contains three projects:

• packages: Monorepo for packages used throughout the system, including data experience packages.
• data-experience: Vue component for the data experience to visualize one data set. Every new dataset we want to visualise starts from there.
• dc-dashboard: A library to generate interactive dashboards.
• experiences: Nuxt app, where digipower.academy lives.

This repo is also dependent on the bubble-server

Setup

You must use the correct version of npm (8.x) and node (18.x) for this project, we recommend using nvm (installation).

First create a new directory, and clone this repo and the bubble-server:

git clone https://github.com/hestiaAI/hestialabs-experiences.git
git clone https://github.com/hestiaAI/hestialabs-bubble-server.git

You must use the correct version of node and npm to run the project (note that nvm for Windows may have a different syntax.) First install nvm if you don't have it already: install instruction or with HomeBrew brew install nvm. Then install lts/hydrogen:

nvm install nvm/hydrogen

And finally set the correct version of npm to run this project:

nvm use lts/hydrogen

Then install and build the bubble-server:

cd hestialabs-bubble-server
# This line install Poetry, only needed if you don't have it already
pip install poetry
poetry install
poetry run pre-commit install

Then install and build the packages:

cd ../hestialabs-experiences/packages
npm i
npm run build
npm run prepare
npm link --workspaces

Then install and build dc-dashboard package:

cd ../dc-dashboard
npm i
npm run build

Then install and build data-experience:

cd ../data-experience

Add an extensionless environment file .env with the following configuration:

echo "NODE_ENV=development" > .env

Then run

npm i
npm run build

You can run the data experience module in development mode with

npm run dev

Then install modules for the Nuxt app:

cd ../experiences
npm i

You can run the Nuxt app in development mode with

npm run dev