2026-03-03 10:20:49 +07:00
{
2026-03-07 08:12:50 +07:00
"name" : "velxio" ,
"homepage" : "https://velxio.dev" ,
2026-03-03 10:20:49 +07:00
"private" : true ,
2026-04-08 00:12:10 +07:00
"version" : "2.0.1" ,
2026-03-03 10:20:49 +07:00
"type" : "module" ,
"scripts" : {
2026-03-04 05:30:25 +07:00
"generate:metadata" : "cd .. && npx tsx scripts/generate-component-metadata.ts" ,
2026-03-07 02:14:26 +07:00
"generate:favicons" : "node ../scripts/generate-favicons.mjs" ,
2026-03-07 09:46:36 +07:00
"generate:og-image" : "node ../scripts/generate-og-image.mjs" ,
2026-03-24 05:04:23 +07:00
"generate:sitemap" : "node scripts/generate-sitemap.mjs" ,
2026-04-15 03:27:30 +07:00
"generate:component-svgs" : "node ../scripts/generate-component-svgs.cjs" ,
"dev" : "npm run generate:metadata && npm run generate:component-svgs && vite" ,
"build" : "npm run generate:metadata && npm run generate:component-svgs && npm run generate:sitemap && tsc -b && vite build && node scripts/prerender-seo.mjs" ,
"build:docker" : "npm run generate:component-svgs && npm run generate:sitemap && vite build && node scripts/prerender-seo.mjs" ,
2026-03-03 10:20:49 +07:00
"lint" : "eslint ." ,
2026-04-22 02:45:45 +07:00
"lint:fix" : "eslint . --fix" ,
"format" : "prettier --write \"src/**/*.{ts,tsx,css}\"" ,
"format:check" : "prettier --check \"src/**/*.{ts,tsx,css}\"" ,
"check" : "npm run lint && npm run format:check" ,
2026-03-05 08:05:23 +07:00
"preview" : "vite preview" ,
"test" : "vitest run" ,
"test:watch" : "vitest" ,
"test:coverage" : "vitest run --coverage" ,
"test:ui" : "vitest --ui"
2026-03-03 10:20:49 +07:00
} ,
"dependencies" : {
"@monaco-editor/react" : "^4.7.0" ,
2026-03-17 00:39:49 +07:00
"@types/react-syntax-highlighter" : "^15.5.13" ,
fix(install): unblock self-hosting + drop forced wokwi clones
Resolves several install pain points reported by users (#108, #120) and
removes the obligatory upstream-clone step that confused contributors and
slowed down every Docker build.
Install fixes:
- nginx: server_name → catch-all default_server, drop Debian's stock site
so reverse-proxied users no longer get the "Welcome to nginx" page.
- entrypoint: auto-generate SECRET_KEY at first boot, persisted under
data/.secret_key. backend/.env is now optional in docker-compose.yml.
- backend: add greenlet>=3.0.0 (SQLAlchemy async dep that was missing on
some Python builds — caused uvicorn startup failures on WSL).
Wokwi libs come from npm:
- @wokwi/elements 1.9.2, avr8js 0.21.0, rp2040js 1.3.2 are pinned in
frontend/package.json. Vite aliases removed.
- Dockerfile.standalone no longer clones avr8js / rp2040js / wokwi-elements
/ wokwi-boards. Frontend stage is just COPY + npm install + build:docker.
- Board SVGs vendored under frontend/public/boards/ (10 deduped against
existing files, 2 truly new). third-party/wokwi-* clones become reference-
only credits — generate-component-metadata.ts skips gracefully when absent.
Production config split out:
- docker-compose.prod.yml, deploy/nginx.prod.conf, nginx-host-velxio*.conf,
update-third-party.bat removed. Production deployment lives in its own
repo: https://github.com/velxio/velxio-prod (host nginx + HTTPS + backups
+ pinned upstream commit).
Verified locally: 1161 frontend tests pass, build:docker completes clean.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 10:04:11 +07:00
"@wokwi/elements" : "1.9.2" ,
2026-03-16 00:04:01 +07:00
"@xterm/addon-fit" : "^0.11.0" ,
"@xterm/xterm" : "^6.0.0" ,
fix(install): unblock self-hosting + drop forced wokwi clones
Resolves several install pain points reported by users (#108, #120) and
removes the obligatory upstream-clone step that confused contributors and
slowed down every Docker build.
Install fixes:
- nginx: server_name → catch-all default_server, drop Debian's stock site
so reverse-proxied users no longer get the "Welcome to nginx" page.
- entrypoint: auto-generate SECRET_KEY at first boot, persisted under
data/.secret_key. backend/.env is now optional in docker-compose.yml.
- backend: add greenlet>=3.0.0 (SQLAlchemy async dep that was missing on
some Python builds — caused uvicorn startup failures on WSL).
Wokwi libs come from npm:
- @wokwi/elements 1.9.2, avr8js 0.21.0, rp2040js 1.3.2 are pinned in
frontend/package.json. Vite aliases removed.
- Dockerfile.standalone no longer clones avr8js / rp2040js / wokwi-elements
/ wokwi-boards. Frontend stage is just COPY + npm install + build:docker.
- Board SVGs vendored under frontend/public/boards/ (10 deduped against
existing files, 2 truly new). third-party/wokwi-* clones become reference-
only credits — generate-component-metadata.ts skips gracefully when absent.
Production config split out:
- docker-compose.prod.yml, deploy/nginx.prod.conf, nginx-host-velxio*.conf,
update-third-party.bat removed. Production deployment lives in its own
repo: https://github.com/velxio/velxio-prod (host nginx + HTTPS + backups
+ pinned upstream commit).
Verified locally: 1161 frontend tests pass, build:docker completes clean.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 10:04:11 +07:00
"avr8js" : "0.21.0" ,
2026-03-03 10:20:49 +07:00
"axios" : "^1.13.6" ,
feat: electrical simulation via ngspice-WASM (eecircuit-engine)
Adds full SPICE-accurate electrical simulation to Velxio, behind a lazy-
loaded ⚡ toolbar toggle. Arduino / ESP32 / RP2040 sketches now co-simulate
with real analog behaviour: correct voltages on wires, real I–V curves on
LEDs, working potentiometers, NTC thermistors read by analogRead(), PWM
driving RC filters, transistors, op-amps, diodes, MOSFETs, etc.
Engine: eecircuit-engine (ngspice compiled to WebAssembly). Main bundle
stays at 2.4 MB; the 20 MB SPICE chunk only loads when the user activates
electrical mode. Disabled at build time via VITE_ELECTRICAL_SIM=false.
Frontend additions:
- simulation/spice/: SpiceEngine wrapper + lazy entry, NetlistBuilder with
UnionFind over wires, componentToSpice mapping (24 metadataIds incl.
real part numbers: 2N2222, 2N3055, BC547, IRF540, 2N7000, 1N4148,
1N4007, 1N4733, LEDs, NTC, op-amp ideal), CircuitScheduler with
debounced coalescing, AVRSpiceBridge for quasi-static co-simulation.
- store/useElectricalStore: Zustand slice, feature-flag aware.
- components/analog-ui/: ⚡ toolbar toggle + SVG voltage overlay.
- components/components-instruments/: Voltmeter, Ammeter probes.
- 62 tests (spice-*, netlist-builder, component-to-spice, instruments).
Sandbox (test/test_circuit/): 47-test validation sandbox that proved
the approach (hand-rolled MNA baseline + ngspice pipeline) before
porting to the app. Kept as reference.
Docs: docs/wiki/circuit-emulation-*.md (13 engineering pages covering
architecture, solvers, components, AVR bridge, gotchas, performance,
integration plan, API reference, appendix) + electrical-simulation-
user-guide.md (end-user facing).
Reference plan: test/test_circuit/plan/phase_8_velxio_implementation.md
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15 19:11:54 +07:00
"eecircuit-engine" : "^1.7.0" ,
2026-03-30 07:27:41 +07:00
"idb-keyval" : "^6.2.2" ,
2026-03-07 10:14:35 +07:00
"jszip" : "^3.10.1" ,
2026-03-30 07:27:41 +07:00
"littlefs" : "^0.1.0" ,
feat(design): tokens, webfonts, Lucide icons, board PNG/WebP picture strip
Foundation
- Add 7 token CSS files in src/tokens/ — semantic colors, 4-pt spacing,
Apple-HIG type ramp, radius/elevation/motion/z-index scales.
- Refactor src/index.css to import tokens and remap legacy aliases
(--accent, --bg, etc.) onto the new --color-* semantics so existing
components keep rendering during migration.
- Drop the duplicate font-family from src/App.css; body inherits from :root.
- Global *:focus-visible ring backed by --color-focus-ring (WCAG 2.4.7).
Webfonts (self-hosted)
- Add Inter.var.woff2 (variable, OFL) and JetBrainsMono.var.woff2 to
public/fonts/. Preloaded in index.html with crossorigin.
- Old stack -apple-system kept as fallback so Mac users still get SF Pro.
- Fixes cross-OS rendering inconsistency (Win/Linux/Android were falling
back to Segoe UI / Roboto, breaking the type grid).
Component primitives
- New src/components/ui/{Button,Card,Input}.tsx + .css. Built on the
semantic tokens, ready for incremental migration of .ap-* CSS classes.
Lucide icons
- Replace 6 inline SVG icon components in LandingPage (IcoChip / IcoCpu /
IcoCode / IcoZap / IcoLayers / IcoMonitor) with lucide-react imports.
Aliased so call sites are unchanged. ~80 lines of inline SVG removed.
- IcoGitHub kept bespoke (filled glyph, brand-correct).
Marketing assets
- Convert top 8 boards to transparent PNG + WebP at 1x / 2x:
Arduino Uno, Nano, Mega 2560, Pi Pico, Pi Pico W, ESP32-C3,
ESP32-DevKit-V1, XIAO ESP32-S3.
- Migrate matching cards in LandingPage and Velxio2Page to <picture>
with WebP > PNG > SVG fallback. Other 8 boards keep <img src=*.svg>
for now (Raspberry Pi 3B, ESP32-CAM, etc.).
- Refresh og-image.png — same canonical URL, new content (4 hero boards
+ branding instead of generic logo card).
- Fix latent bug in LandingPage: ESP32 DevKit V1 card was loading
esp32-devkit-c-v4.svg; now uses esp32-devkit-v1.{webp,png,svg}.
Build verified: npm run build:docker succeeds, 246 SEO pages prerender.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-08 01:45:44 +07:00
"lucide-react" : "^0.460.0" ,
2026-03-03 10:20:49 +07:00
"react" : "^19.2.0" ,
"react-dom" : "^19.2.0" ,
2026-03-05 04:03:54 +07:00
"react-router-dom" : "^7.13.1" ,
fix(install): unblock self-hosting + drop forced wokwi clones
Resolves several install pain points reported by users (#108, #120) and
removes the obligatory upstream-clone step that confused contributors and
slowed down every Docker build.
Install fixes:
- nginx: server_name → catch-all default_server, drop Debian's stock site
so reverse-proxied users no longer get the "Welcome to nginx" page.
- entrypoint: auto-generate SECRET_KEY at first boot, persisted under
data/.secret_key. backend/.env is now optional in docker-compose.yml.
- backend: add greenlet>=3.0.0 (SQLAlchemy async dep that was missing on
some Python builds — caused uvicorn startup failures on WSL).
Wokwi libs come from npm:
- @wokwi/elements 1.9.2, avr8js 0.21.0, rp2040js 1.3.2 are pinned in
frontend/package.json. Vite aliases removed.
- Dockerfile.standalone no longer clones avr8js / rp2040js / wokwi-elements
/ wokwi-boards. Frontend stage is just COPY + npm install + build:docker.
- Board SVGs vendored under frontend/public/boards/ (10 deduped against
existing files, 2 truly new). third-party/wokwi-* clones become reference-
only credits — generate-component-metadata.ts skips gracefully when absent.
Production config split out:
- docker-compose.prod.yml, deploy/nginx.prod.conf, nginx-host-velxio*.conf,
update-third-party.bat removed. Production deployment lives in its own
repo: https://github.com/velxio/velxio-prod (host nginx + HTTPS + backups
+ pinned upstream commit).
Verified locally: 1161 frontend tests pass, build:docker completes clean.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 10:04:11 +07:00
"rp2040js" : "1.3.2" ,
2026-03-17 00:39:49 +07:00
"react-syntax-highlighter" : "^16.1.1" ,
feat(metrics): add usage analytics dashboard with country tracking
Track per-user, per-project, and per-board usage to inform pricing tier
decisions. Adds an admin dashboard with KPIs (DAU/WAU/MAU, totals,
success rate), time-series charts for compiles/runs, board family +
FQBN breakdowns, "board diversity" pie chart (key freemium signal),
top users/projects, and per-country breakdown via Cloudflare's
CF-IPCountry header. Admin can now also view private projects.
Backend:
- New UsageEvent table (append-only event log with user_id, project_id,
event_type, board_fqbn/family, country, error_kind, duration_ms)
- Aggregate counters on User (total_compiles/runs/errors, last_active,
signup_country, last_country) and Project (compile/run/update counts,
last_compiled/run timestamps) kept in sync by MetricsService for O(1)
dashboard reads
- 10 admin endpoints under /api/admin/metrics/{overview, timeseries,
boards, board-diversity, top-users, top-projects, countries,
users/{id}, projects/{id}}
- POST /api/metrics/run for client-side run telemetry
- Country detection via cf-ipcountry header (no DB / no API calls)
- Auto-migrations in lifespan for legacy DBs
Frontend:
- recharts-powered Dashboard tab with KPI cards and 4 charts
- New Boards tab with per-family + per-FQBN breakdown
- Country column with flag emoji on Users tab
- Top countries card on Dashboard
- compileCode now forwards project_id; Run button reports via WS
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-04-26 05:46:52 +07:00
"recharts" : "^3.8.1" ,
2026-03-03 10:20:49 +07:00
"zustand" : "^5.0.11"
} ,
"devDependencies" : {
"@eslint/js" : "^9.39.1" ,
2026-03-07 10:14:35 +07:00
"@types/jszip" : "^3.4.0" ,
2026-03-03 10:20:49 +07:00
"@types/node" : "^24.11.0" ,
"@types/react" : "^19.2.7" ,
"@types/react-dom" : "^19.2.3" ,
"@vitejs/plugin-react" : "^5.1.1" ,
2026-03-05 08:05:23 +07:00
"@vitest/coverage-v8" : "^4.0.18" ,
"@vitest/ui" : "^4.0.18" ,
2026-03-03 10:20:49 +07:00
"eslint" : "^9.39.1" ,
2026-04-22 02:45:45 +07:00
"eslint-config-prettier" : "10.1.8" ,
2026-03-03 10:20:49 +07:00
"eslint-plugin-react-hooks" : "^7.0.1" ,
"eslint-plugin-react-refresh" : "^0.4.24" ,
"globals" : "^16.5.0" ,
2026-03-05 08:05:23 +07:00
"jsdom" : "^28.1.0" ,
2026-04-22 02:45:45 +07:00
"prettier" : "3.8.3" ,
2026-03-03 10:20:49 +07:00
"typescript" : "~5.9.3" ,
"typescript-eslint" : "^8.48.0" ,
2026-03-05 08:05:23 +07:00
"vite" : "^7.3.1" ,
"vitest" : "^4.0.18"
2026-03-03 10:20:49 +07:00
}
}