# opulo-inc/viagrid architecture

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

- Interactive diagram: https://gitdiagram.com/opulo-inc/viagrid
- Repository: https://github.com/opulo-inc/viagrid

## Overview

ViaGrid is a collection of PCB blank templates and supporting fabrication assets, rather than a software runtime. The documented workflow is to start a KiCad project from a blank template, design and route using its pre-embedded via grid, then fabricate the board using a supported process. The README also documents Eagle board files, LightBurn laser setup, and an alignment jig. Relationships shown here come from README instructions; source code was not provided.

Main entry points: [`VIAGRID BLANK FILES/9055 STANDARD/KICAD/MANUFACTURING/viagrid.kicad_pcb`](https://github.com/opulo-inc/viagrid/blob/main/VIAGRID%20BLANK%20FILES/9055%20STANDARD/KICAD/MANUFACTURING/viagrid.kicad_pcb) (9055 KiCad blank), [`VIAGRID BLANK FILES/6034 STANDARD/KICAD/VIAGRID_6034_STANDARD.kicad_pcb`](https://github.com/opulo-inc/viagrid/blob/main/VIAGRID%20BLANK%20FILES/6034%20STANDARD/KICAD/VIAGRID_6034_STANDARD.kicad_pcb) (6034 KiCad blank), [`LEGACY_FILES/lightburn/viagrid.lbrn2`](https://github.com/opulo-inc/viagrid/blob/main/LEGACY_FILES/lightburn/viagrid.lbrn2) (Laser layout), [`VIAGRID BLANK FILES/6034 STANDARD/KICAD/viagrid_6034_template/6034_template.kicad_pcb`](https://github.com/opulo-inc/viagrid/blob/main/VIAGRID%20BLANK%20FILES/6034%20STANDARD/KICAD/viagrid_6034_template/6034_template.kicad_pcb) (6034 KiCad template)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_templates["PCB templates"]
  node_template9055["9055 KiCad blank<br/>[viagrid.kicad_pcb]"]
  node_template6034["6034 KiCad blank"]
  node_kicad6034project["6034 KiCad template"]
  node_eagle9055["9055 Eagle board"]
  node_eagle6034["6034 Eagle board"]
end

subgraph group_design["PCB design"]
  node_designroute["Via-grid routing"]
end

subgraph group_fabrication["Fabrication assets"]
  node_laserfile["Laser layout<br/>[viagrid.lbrn2]"]
  node_alignmentjig["Alignment jig"]
end

node_designer(("PCB designer"))
node_kicad["KiCad"]
node_eagle["Eagle"]
node_lightburn["LightBurn"]
node_uvlaser["UV DPSS laser"]
node_mlletch["MLL and etching"]
node_cnc["CNC machining"]

node_designer -->|"creates project"| node_kicad
node_kicad -->|"starts from"| node_kicad6034project
node_designer -->|"downloads blank"| node_template9055
node_designer -->|"downloads blank"| node_template6034
node_designer -->|"uses board"| node_eagle9055
node_designer -->|"uses board"| node_eagle6034
node_designer -->|"designs and routes"| node_designroute
node_designroute -->|"uses embedded vias"| node_template9055
node_designroute -->|"uses embedded vias"| node_template6034
node_designer -->|"opens layout"| node_laserfile
node_designer -->|"assembles jig"| node_alignmentjig
node_lightburn -->|"opens layout"| node_laserfile
node_designer -->|"fabricates with"| node_uvlaser
node_designer -->|"fabricates with"| node_mlletch
node_designer -->|"fabricates with"| node_cnc

click node_template9055 "https://github.com/opulo-inc/viagrid/blob/main/VIAGRID%20BLANK%20FILES/9055%20STANDARD/KICAD/MANUFACTURING/viagrid.kicad_pcb"
click node_template6034 "https://github.com/opulo-inc/viagrid/blob/main/VIAGRID%20BLANK%20FILES/6034%20STANDARD/KICAD/VIAGRID_6034_STANDARD.kicad_pcb"
click node_kicad6034project "https://github.com/opulo-inc/viagrid/blob/main/VIAGRID%20BLANK%20FILES/6034%20STANDARD/KICAD/viagrid_6034_template/6034_template.kicad_pcb"
click node_eagle9055 "https://github.com/opulo-inc/viagrid/blob/main/VIAGRID%20BLANK%20FILES/9055%20STANDARD/EAGLE/VIAGRID_9055_STANDARD.brd"
click node_eagle6034 "https://github.com/opulo-inc/viagrid/blob/main/VIAGRID%20BLANK%20FILES/6034%20STANDARD/EAGLE/VIAGRID_6034_STANDARD.brd"
click node_laserfile "https://github.com/opulo-inc/viagrid/blob/main/LEGACY_FILES/lightburn/viagrid.lbrn2"
click node_alignmentjig "https://github.com/opulo-inc/viagrid/tree/main/LEGACY_FILES/jigs/alignment_jig"

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_template9055,node_template6034,node_kicad6034project,node_eagle9055,node_eagle6034 toneBlue
class node_designroute toneAmber
class node_laserfile,node_alignmentjig toneMint
class node_designer,node_kicad,node_eagle,node_lightburn,node_uvlaser,node_mlletch,node_cnc toneIndigo
```

## Components

### PCB templates

- [9055 KiCad blank](https://github.com/opulo-inc/viagrid/blob/main/VIAGRID%20BLANK%20FILES/9055%20STANDARD/KICAD/MANUFACTURING/viagrid.kicad_pcb): `VIAGRID BLANK FILES/9055 STANDARD/KICAD/MANUFACTURING/viagrid.kicad_pcb`
- [6034 KiCad blank](https://github.com/opulo-inc/viagrid/blob/main/VIAGRID%20BLANK%20FILES/6034%20STANDARD/KICAD/VIAGRID_6034_STANDARD.kicad_pcb): `VIAGRID BLANK FILES/6034 STANDARD/KICAD/VIAGRID_6034_STANDARD.kicad_pcb`
- [6034 KiCad template](https://github.com/opulo-inc/viagrid/blob/main/VIAGRID%20BLANK%20FILES/6034%20STANDARD/KICAD/viagrid_6034_template/6034_template.kicad_pcb): `VIAGRID BLANK FILES/6034 STANDARD/KICAD/viagrid_6034_template/6034_template.kicad_pcb`
- [9055 Eagle board](https://github.com/opulo-inc/viagrid/blob/main/VIAGRID%20BLANK%20FILES/9055%20STANDARD/EAGLE/VIAGRID_9055_STANDARD.brd): `VIAGRID BLANK FILES/9055 STANDARD/EAGLE/VIAGRID_9055_STANDARD.brd`
- [6034 Eagle board](https://github.com/opulo-inc/viagrid/blob/main/VIAGRID%20BLANK%20FILES/6034%20STANDARD/EAGLE/VIAGRID_6034_STANDARD.brd): `VIAGRID BLANK FILES/6034 STANDARD/EAGLE/VIAGRID_6034_STANDARD.brd`

### PCB design

- **Via-grid routing**

### Fabrication assets

- [Laser layout](https://github.com/opulo-inc/viagrid/blob/main/LEGACY_FILES/lightburn/viagrid.lbrn2): `LEGACY_FILES/lightburn/viagrid.lbrn2`
- [Alignment jig](https://github.com/opulo-inc/viagrid/tree/main/LEGACY_FILES/jigs/alignment_jig): `LEGACY_FILES/jigs/alignment_jig`

### Other components

- **PCB designer**
- **KiCad**
- **Eagle**
- **LightBurn**
- **UV DPSS laser**
- **MLL and etching**
- **CNC machining**

## Connections

- PCB designer → KiCad: creates project (evidence: `README.md`)
- KiCad → 6034 KiCad template: starts from (evidence: `README.md`)
- PCB designer → 9055 KiCad blank: downloads blank (evidence: `README.md`)
- PCB designer → 6034 KiCad blank: downloads blank (evidence: `README.md`)
- PCB designer → 9055 Eagle board: uses board (evidence: `README.md`)
- PCB designer → 6034 Eagle board: uses board (evidence: `README.md`)
- PCB designer → Via-grid routing: designs and routes (evidence: `README.md`)
- Via-grid routing → 9055 KiCad blank: uses embedded vias (evidence: `README.md`)
- Via-grid routing → 6034 KiCad blank: uses embedded vias (evidence: `README.md`)
- PCB designer → Laser layout: opens layout (evidence: `README.md`)
- PCB designer → Alignment jig: assembles jig (evidence: `README.md`)
- LightBurn → Laser layout: opens layout (evidence: `README.md`)
- PCB designer → UV DPSS laser: fabricates with (evidence: `README.md`)
- PCB designer → MLL and etching: fabricates with (evidence: `README.md`)
- PCB designer → CNC machining: fabricates with (evidence: `README.md`)
