# musi95/grid0 architecture

> Architecture diagram of the GitHub repository musi95/grid0, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/musi95/grid0
- Repository: https://github.com/musi95/grid0

## Overview

GRID0 is a setup hub for connecting emulator, modded Switch, and stock Switch players to one overlay network. Its principal workflow is to choose the matching environment, follow its setup guide, and connect through the appropriate client, sysmodule, or relay. This repository contains only the README and images, so the map reflects documented setup steps rather than implementation internals; the referenced clients and services are external projects.

Main entry points: [`README.md`](https://github.com/musi95/grid0/blob/main/README.md) (Emulator setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guides["Setup guides"]
  node_emulator_guide["Emulator setup<br/>[README.md]"]
  node_cfw_guide["Modded Switch setup<br/>[README.md]"]
  node_ofw_guide["Stock Switch setup<br/>[README.md]"]
end

subgraph group_external_tools["External tools"]
  node_sys_grid0["sys-GRID0"]
  node_grid0_relay["GRID0 relay"]
  node_zerotier["ZeroTier One"]
  node_npcap["Npcap"]
end

subgraph group_network["Network"]
  node_grid0_network{{"GRID0 network"}}
end

node_player(("Player"))
node_emulator["Emulator"]
node_switch["Switch console"]
node_pc["Relay PC"]

node_player -->|"reads"| node_emulator_guide
node_player -->|"reads"| node_cfw_guide
node_player -->|"reads"| node_ofw_guide
node_emulator_guide -->|"configures"| node_zerotier
node_emulator_guide -->|"enables LAN"| node_emulator
node_emulator -->|"joins via"| node_grid0_network
node_cfw_guide -->|"installs"| node_sys_grid0
node_sys_grid0 -->|"connects to"| node_grid0_network
node_ofw_guide -->|"configures"| node_grid0_relay
node_grid0_relay -->|"launches and joins"| node_zerotier
node_grid0_relay -->|"installs"| node_npcap
node_grid0_relay -->|"runs on"| node_pc
node_switch -->|"shares LAN"| node_pc
node_grid0_relay -->|"bridges traffic"| node_switch
node_zerotier -->|"connects to"| node_grid0_network

click node_emulator_guide "https://github.com/musi95/grid0/blob/main/README.md"
click node_cfw_guide "https://github.com/musi95/grid0/blob/main/README.md"
click node_ofw_guide "https://github.com/musi95/grid0/blob/main/README.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_emulator_guide,node_cfw_guide,node_ofw_guide toneBlue
class node_sys_grid0,node_grid0_relay,node_zerotier,node_npcap toneAmber
class node_grid0_network toneMint
class node_player,node_emulator,node_switch,node_pc toneIndigo
```

## Components

### Setup guides

- [Emulator setup](https://github.com/musi95/grid0/blob/main/README.md): `README.md`
- [Modded Switch setup](https://github.com/musi95/grid0/blob/main/README.md): `README.md`
- [Stock Switch setup](https://github.com/musi95/grid0/blob/main/README.md): `README.md`

### External tools

- **sys-GRID0**
- **GRID0 relay**
- **ZeroTier One**
- **Npcap**

### Network

- **GRID0 network**

### Other components

- **Player**
- **Emulator**
- **Switch console**
- **Relay PC**

## Connections

- Player → Emulator setup: reads
- Player → Modded Switch setup: reads
- Player → Stock Switch setup: reads
- Emulator setup → ZeroTier One: configures
- Emulator setup → Emulator: enables LAN
- Emulator → GRID0 network: joins via
- Modded Switch setup → sys-GRID0: installs
- sys-GRID0 → GRID0 network: connects to
- Stock Switch setup → GRID0 relay: configures
- GRID0 relay → ZeroTier One: launches and joins
- GRID0 relay → Npcap: installs
- GRID0 relay → Relay PC: runs on
- Switch console → Relay PC: shares LAN
- GRID0 relay → Switch console: bridges traffic
- ZeroTier One → GRID0 network: connects to
