Studio

Traverse Studio is a web-based interface for querying, visualizing, and managing your graph databases. It ships with the server and runs on the HTTP port.

Accessing Studio

When the server is started with an HTTP listen address, Studio is available at that address:

traverse-server --http-listen 0.0.0.0:7691

Open http://localhost:7691 in your browser. Log in with the API key printed at server startup (prefixed tvs_).

Dashboard

The dashboard shows benchmark comparisons between Traverse, Neo4j, and Memgraph across query categories (read, write, scan, aggregate, traversal). Includes:

• QPS (queries per second) bar charts per query
• Speedup ratios across engines
• Concurrency level selection (1, 4, 12 clients)
• Scaling analysis charts

Query Editor

The query editor is the main workspace:

• Syntax highlighting — Monaco-based editor with Cypher language support and light/dark themes
• Code completion — schema-aware suggestions for labels, relationship types, and property keys
• Query parameters — pass parameters alongside your query
• Query history — last 100 executed queries with timing and row counts, stored in the browser
• Saved queries — save and name queries for reuse (persisted server-side per database)
• Share query — generate a shareable URL
• Per-database drafts — editor content is saved per database in the browser

Query Palette

Press Ctrl+K to open the query palette — a quick-access panel to search and filter saved queries and recent history. Navigate with arrow keys, press Enter to select, or Escape to close. You can also delete saved queries from the palette.

Keyboard Shortcuts

Results

Query results can be viewed in three modes. Studio automatically switches to graph view when results contain nodes, edges, or paths.

Graph View

Interactive graph visualization powered by WebGL:

• Layout algorithms — ForceAtlas 2 and D3 Force for automatic positioning
• Click a node to view its properties in a tooltip
• Double-click a node to expand its relationships (queries neighbors and merges into the graph)
• Controls — zoom in/out, fit to screen, re-layout, export as PNG
• Render limits — configurable max nodes and edges (defaults: 3,500 nodes, 8,500 edges). A counter in the bottom-left shows current node/edge counts.
• Edge simplification — parallel edges between the same nodes are rendered as curved lines

Table View

Tabular display with column headers matching your RETURN clause.

JSON View

Structured JSON output of the result data.

Query Statistics

All views show a timing breakdown and modification stats:

• Timing — parse time, planning time, execution time, and total roundtrip
• Stats — row count, nodes/edges created, properties set, labels added

Live Query Streaming

Studio connects to the server via WebSocket (/ws) for row-by-row result streaming. This allows results to appear progressively as the server produces them, rather than waiting for the full result set. The connection auto-reconnects with exponential backoff if interrupted.

Graph Styling

Customize how nodes and edges appear in the graph view:

• Node color — assign colors per label (auto-assigned from a palette by default, with separate light/dark theme palettes)
• Node size — adjust relative size per label
• Node shape — circle or hexagon
• Edge color — assign colors per relationship type
• Edge thickness — adjust per relationship type

Styles are persisted per database in a .studio.json file alongside the .tvdb file. Changes auto-save.

Schema Browser

Browse the structure of your graph:

• Node labels with their properties and inferred types
• Relationship types with their properties
• Indexes and constraints
• Database rename and drop operations (drop requires --allow-drop-database)

Import

Studio provides three import methods:

Cypher Import

Paste Cypher CREATE statements for batch import.

CSV Node Import

Upload a CSV file and map columns to node properties:

• Column mapping with type selection (string, integer, float, boolean)
• Delimiter options (comma, tab, or custom)
• Preview with sample rows
• Automatic header detection with skip-header option

CSV Edge Import

Upload a CSV file to create relationships:

• Source and target node matching by label and property
• Edge type specification
• Column selection for source/target identifiers

Maximum upload size: 512 MB. Import results show nodes/relationships created, properties set, and any errors by row.

Database Management

Switch between databases using the database selector. From Studio you can:

• Create new databases
• Rename databases
• Drop databases (requires --allow-drop-database on the server)

File Manager

Manage .tvdb database files on the server:

• Upload .tvdb files with progress tracking
• Download databases as .tvdb files
• Load/unload databases into memory
• Delete files
• File size and loaded status displayed per file

Long-running operations (drop, unload, load) run asynchronously with status polling.

Aliases

Create and manage database aliases — logical names that point to a physical database. Useful for switching between production and staging without changing connection strings.

User Management

Create and manage users with role-based access:

• Admin — full access including user and database management
• Editor — read and write queries, no management
• Reader — read-only queries

Examples

Pre-built example graphs you can import with one click to explore Traverse. Categories include entertainment, business, social, science, and technology datasets. Each example creates a new database and runs a sample query.

Graph Assistant

An AI-powered assistant that helps you write Cypher queries and explore your graph data.

• Schema-aware — the assistant knows your graph structure (labels, relationship types, properties, indexes)
• Query-aware — sees your current query and last execution timing
• Streaming responses — answers stream in real-time via Server-Sent Events
• Run suggestions — copy or execute suggested Cypher queries directly in the editor
• Per-database history — separate conversation per database, persisted in the browser
• Abort — stop a streaming response mid-generation

Cypher Reference

A searchable reference of supported Cypher commands built into Studio, grouped by category with syntax examples. Filter by category or search term, and copy any example directly into the query editor.

Feedback

Submit bug reports, feature requests, or general feedback directly from Studio. You can optionally attach the current query with its timing metrics (parse, plan, execution times) and provide an email for follow-up.

Settings

Settings are stored in the browser and persist across sessions. Studio also remembers which panel was open on reload.

License Activation

Activate your Traverse license from Studio to unlock user management, Graph Assistant, and remove trial restrictions. Studio guides you through the activation flow and shows:

• Current plan and subscription status (trial, active, grace period, expired)
• Trial days remaining
• Registered devices with fingerprints and last-seen timestamps
• Device removal and license deactivation