Skip to content

Using the App

The Graffold web app (app.graffold.com) is where you build knowledge graphs, define ontologies, harmonize files, and query your data in natural language.

This section documents the app UI. For the API and SDK, see Development.

Layout

The app uses a single unified sidebar on the left and a main content area on the right.

┌────────────┬─────────────────────────────────┐
│  Sidebar   │                                 │
│            │                                 │
│  Sessions  │        Active page              │
│  Nav       │    (Explore / Build / Drive …)  │
│  Config    │                                 │
│  Themes    │                                 │
└────────────┴─────────────────────────────────┘

The sidebar holds three things:

  1. Sessions — your saved workspaces, each scoped to a database, model, and files.
  2. Navigation — links to each page (Explore, Build, Drive, Analyze, Insights).
  3. Config & themes — backend/model selectors, health dots, and the theme picker.

On mobile the sidebar collapses to a hamburger toggle.

Pages at a glance

Page Route What it does
Explore /explore Query a knowledge graph in natural language; branch threads
Build /build Create KGs, define ontologies, and ingest data (3 tabs)
Drive /drive Harmonize scattered files into a graph (GrafDrive)
Analyze /analyze Session-aware data analysis notebook
Insights /insights Cross-graph knowledge insights
Admin /admin Tenant admin, health, Grafana

Sessions

A session bundles your working context so you can pick up where you left off:

  • Database — which knowledge graph you're querying (Memgraph, Neo4j, FalkorDB)
  • Model — the LLM used for extraction and answers
  • Agent type — the query agent behavior
  • Files — documents uploaded to this session
  • Threads — individual query conversations
  • Workspace — a linked Drive workspace (optional)

Sessions are stored in your browser (localStorage) and survive page reloads. Create a new session from the sidebar; each new query thread attaches to the active session so history stays organized.

Backend & model selection

Graffold is platform-agnostic. The config bar lets you switch between graph backends and LLM providers without changing code:

  • Graph backend — Memgraph (default), Neo4j, or FalkorDB. Switching updates the database list and re-fetches available graphs.
  • LLM — Cloudflare Workers AI (default), plus any provider your tier allows.

Three health dots in the header show live status of the API, graph database, and LLM. Hover for details.

Themes

The app ships with 18 color themes (11 dark, 7 light), selectable from the theme picker in the sidebar. Default is Tokyo Night Day.

Dark: Terminal · Catppuccin · Tokyo Night · Dracula · Nord · Gruvbox · One Dark · Solarized · Kanagawa · Rosé Pine · Vesper

Light: One Light · Catppuccin Latte · Tokyo Night Day · Gruvbox Light · Solarized Light · Kanagawa Lotus · Rosé Pine Dawn

Use the day/night toggle to flip between a theme and its light/dark counterpart, or cycle through all themes. Your choice persists across sessions.