Core Concepts
Understand the fundamental concepts behind NSG spatial graphs.
Key Terms
Nested Spatial Graph
A graph where nodes can contain child layers. This allows infinite depth navigation through complex systems.
Layer
A navigable visual space containing nodes and edges. Each layer can have its own layout mode and archetype renderer.
Stack Composition
A vertical or structured composition of multiple layers. Used to represent systems with clear hierarchical separation.
Archetype
A visual renderer selected for a type of system. Different archetypes optimize for different data structures and relationships.
Node
A visible object representing a file, folder, agent, service, process, dataset, cluster, or custom entity.
Edge
A relationship between nodes. Can represent dependencies, data flow, messages, imports, exports, or custom connections.
Portal
A node with a childLayerId, meaning it can be entered as a deeper visual world. Portals enable nested navigation.
Visual Archetypes
Archetypes define how a layer is rendered. Each archetype is optimized for a specific type of system:
agent_meshMulti-agent systems, AI coordination
oracle_clusterSignal aggregation, prediction systems
execution_railsPipelines, DAGs, workflows
data_cityStorage, databases, warehouses
module_systemLibraries, components, packages
network_meshInfrastructure, distributed systems
monitoring_fieldTelemetry, health, diagnostics
file_systemFiles and folder structures
dependency_graphImport and export relationships
Edge Types
Edges define relationships between nodes. Common edge types include:
dependencyflowmessageimportexportcontroldatamonitorcallrouteHow It Works
- 1Input
NSG receives your graph data via .nsg.json, API, or repo import
- 2Analysis
The runtime analyzes structure, relationships, and metadata
- 3Layout
Nodes are positioned using the appropriate layout algorithm
- 4Render
The archetype renderer creates the visual representation
- 5Navigate
Users can zoom, focus, enter portals, and inspect details