velxio_docs

August 13, 2026 · View on GitHub

Official end-user documentation for Velxio, the online electronics simulator. Built with Astro Starlight.

Served in production at https://velxio.dev/docs/ (the site is built with base: "/docs", same pattern as the blog at /blog/).

Quick start

npm install
npm run dev          # http://localhost:4321/docs/
npm run build        # static output in dist/
npm run preview      # serve the build locally

Layout

Path	What's there
`src/content/docs/`	English source content (default locale, served at `/docs/`)
`src/content/docs/es/`	Spanish translations (served at `/docs/es/`)
`src/assets/docs/`	Screenshots, generated by `scripts/shots.mjs` — do not edit by hand
`src/styles/custom.css`	Velxio brand accent over the Starlight theme
`astro.config.mjs`	Site config: base `/docs`, locales, the 10-section sidebar

Content sections

Getting Started · Circuit Editor · Code & Run · Instruments · Boards · Parts Reference · WiFi & IoT · Custom Chips · AI Assistant · Account & Plans

Conventions

English is the source language; other locales are filled by the translation pipeline (ported from velxio_blog).
Screenshots are captured by script against a staging instance so they can be regenerated when the UI changes — never pasted in by hand.
Board and part reference pages are generated from the app's component registry (gen-parts in the private repo), so pinouts always match the canvas.