How davidmonterocrespo24/velxio works
Velxio is a browser-based embedded-board and circuit emulator. The main workflow is to create or load a project, place and wire components, compile firmware, and run it in a board simulator while observing serial and electrical behavior. The frontend owns project/editor state and dispatches among CPU-family runtimes; backend APIs provide compilation and selected emulation services. The README documents additional capabilities such as examples, libraries, custom chips, SPICE, and MCP tools. Some links below rely on README-level workflow documentation because their implementation was not sampled.
Main entry points: useSimulatorStore.ts Simulator State · EditorPage.tsx Project Editor · main.py Backend API · compile.py Compile Routes
Components 24
Project Workspace
- Project Editor
frontend/src/pages/EditorPage.tsx - Project State
frontend/src/store/useProjectStore.ts - Simulator State
frontend/src/store/useSimulatorStore.ts - Compile Client
frontend/src/services/compilation.ts
Circuit Simulation
- AVR Runtime
frontend/src/simulation/AVRSimulator.ts - RP2040 Runtime
frontend/src/simulation/RP2040Simulator.ts - ESP32 Runtime
frontend/src/simulation/Esp32Bridge.ts - ESP32-C3 Runtime
frontend/src/simulation/Esp32C3Simulator.ts - Pi Runtime
frontend/src/simulation/PiBridgeShim.ts - Pin Manager
frontend/src/simulation/PinManager.ts - SPICE Circuit Solver
frontend/src/simulation/spice/CircuitSimulationService.ts - Custom Chip Runtime
frontend/src/simulation/customChips/ChipRuntime.ts
Backend Services
- Backend API
backend/app/main.py - Compile Routes
backend/app/api/routes/compile.py - Arduino Compiler
backend/app/services/arduino_cli.py - ESP-IDF Compiler
backend/app/services/espidf_compiler.py - Simulation Routes
backend/app/api/routes/simulation.py - ESP Emulation Manager
backend/app/services/esp_qemu_manager.py
Learning and Components
- Project Examples
frontend/src/data/examples.ts - Component Catalog
frontend/src/services/ComponentRegistry.ts - Library Manager
frontend/src/components/simulator/LibraryManagerModal.tsx
Extensions
- MCP Tools
backend/app/mcp/server.py - IoT Gateway
backend/app/api/routes/iot_gateway.py
Other components
- Engineer
Connections 24
- Engineer → Project Editor: edits projects
README.md - Project Editor → Project State: updates project
- Project Examples → Project Editor: loads projects
- Engineer → Component Catalog: selects parts
README.md - Project Editor → Simulator State: runs project
- Simulator State → AVR Runtime: dispatches runtime
frontend/src/store/useSimulatorStore.ts - Simulator State → RP2040 Runtime: dispatches runtime
frontend/src/store/useSimulatorStore.ts - Simulator State → ESP32-C3 Runtime: dispatches runtime
frontend/src/store/useSimulatorStore.ts - Simulator State → ESP32 Runtime: dispatches runtime
frontend/src/store/useSimulatorStore.ts - Simulator State → Pi Runtime: dispatches runtime
frontend/src/store/useSimulatorStore.ts - Simulator State → Pin Manager: uses pin state
frontend/src/store/useSimulatorStore.ts - Project Editor → Compile Client: requests compile
README.md - Compile Client → Backend API: sends compile request
README.md - Backend API → Compile Routes: routes requests
backend/app/main.py - Compile Routes → Arduino Compiler: compiles sketches
backend/app/api/routes/compile.py - Compile Routes → ESP-IDF Compiler: compiles ESP-IDF
backend/app/api/routes/compile.py - Backend API → Simulation Routes: routes simulation
backend/app/main.py - Simulation Routes → ESP Emulation Manager: manages emulation
backend/app/api/routes/simulation.py - Simulator State → SPICE Circuit Solver: simulates analog circuits
- Engineer → Library Manager: manages libraries
README.md - Library Manager → Backend API: requests libraries
- Engineer → Custom Chip Runtime: creates chips
README.md - Engineer → MCP Tools: uses agent tools
README.md - Engineer → IoT Gateway: uses device gateway