N
NSG/Docs

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_mesh

Multi-agent systems, AI coordination

oracle_cluster

Signal aggregation, prediction systems

execution_rails

Pipelines, DAGs, workflows

data_city

Storage, databases, warehouses

module_system

Libraries, components, packages

network_mesh

Infrastructure, distributed systems

monitoring_field

Telemetry, health, diagnostics

file_system

Files and folder structures

dependency_graph

Import and export relationships

Edge Types

Edges define relationships between nodes. Common edge types include:

dependencyflowmessageimportexportcontroldatamonitorcallroute

How It Works

  1. 1
    Input

    NSG receives your graph data via .nsg.json, API, or repo import

  2. 2
    Analysis

    The runtime analyzes structure, relationships, and metadata

  3. 3
    Layout

    Nodes are positioned using the appropriate layout algorithm

  4. 4
    Render

    The archetype renderer creates the visual representation

  5. 5
    Navigate

    Users can zoom, focus, enter portals, and inspect details