This repository contains a TypeScript web application to demo sigma.js on exploring the RICardo datasets. It has been developed to illustrate my presentation at FOSDEM 2025 Data Analytics Devroom, Developing Custom UIs to Explore Graph Databases Using Sigma.js.

The web application is very light, and simply provides two different views on the dataset. It's built with Vite and TypeScript, and uses web components.

There is no public instance, since I don't want to maintain some Neo4J server. But you can run this project locally. For this, you need:

• A clean and recent Node + NPM environment
• A clean Docker installation, or some Neo4J instance

The Neo4J graph can be generated from open CSV files, directly available from different RICardo repositories.

1. Spawn a Neo4J Docker container: npm run docker:start
2. Download the CSV files and feed the Neo4J graph: npm run data:prepare

If you directly use a Neo4J instance instead, you first need to update ./bin/config.ts to help the scripts connect to the database.

1. Install dependencies: npm install
2. Run the development version: npm run dev

Then, you can access the website at localhost:5173.

1. Install dependencies: npm install
2. Build the production version: npm run build

Then, the whole website is built under the dist folder.