helix-dashboard
Overview
This is a dashboard for helixdb. It allows you to view and interact with your helixdb database. You can access the dashboard repository here.Query Format
The dashboard works best when your queries follow this naming convention:- Creating or linking nodes and edges should start with ācreateā or ālinkā (e.g., ācreatePatientā or ālinkPatientToDoctorā)
- Searching or getting nodes and edges should start with āgetā (e.g., āgetPatientā or āgetDoctorā)
- Updating nodes and edges should start with āupdateā (e.g., āupdatePatientā or āupdateDoctorā)
- Deleting nodes and edges should start with ādeleteā (e.g., ādeletePatientā or ādeleteDoctorā)
Setup
Local Development
- Ensure your HelixDB instance is running (default port: 6969)
- Navigate to the
frontenddirectory and runnpm installto install dependencies - Run
npm run devto start the development server - The application will be available at
http://localhost:3000
Docker (Production)
For production deployment using Docker:Environment Variables
Create a.env file in the frontend directory to configure your HelixDB connection:
HELIX_HOST- HelixDB host (default: localhost)HELIX_PORT- HelixDB port (default: 6969)HELIX_CLOUD_URL- HelixDB cloud URL (for cloud deployments)HELIX_API_KEY- HelixDB API key (for cloud deployments)
Visualizer Setup
NOTE:- You may need to stop your current HelixDB instance and deploy again using
helix push <instance_name>to use the visualizer. - In some browsers like Brave, you may not be able to click on all nodes properly. We recommend using Chrome, Firefox, or Safari for the best experience.
- For performance reasons, we recommend not visualizing more than 3000 nodes as it may cause browser performance issues.
- Ensure your HelixDB instance is deployed using
helix push <instance_name>to use the visualizer - Start the dashboard application (locally or via Docker)