2026-03-05 05:28:33 +07:00
|
|
|
# Dependencies
|
|
|
|
|
node_modules/
|
|
|
|
|
**/node_modules/
|
|
|
|
|
|
2026-05-04 11:08:23 +07:00
|
|
|
# npm lock files — never include them in the build context. A host-generated
|
|
|
|
|
# lock pins platform-specific Rollup/esbuild binaries and breaks the Linux
|
|
|
|
|
# build inside the image.
|
|
|
|
|
package-lock.json
|
|
|
|
|
**/package-lock.json
|
|
|
|
|
|
2026-03-05 05:28:33 +07:00
|
|
|
# Python
|
|
|
|
|
__pycache__/
|
|
|
|
|
*.py[cod]
|
|
|
|
|
venv/
|
|
|
|
|
env/
|
|
|
|
|
*.egg-info/
|
|
|
|
|
|
|
|
|
|
# Build outputs (will be built inside Docker)
|
|
|
|
|
frontend/dist/
|
|
|
|
|
frontend/.vite/
|
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
|
|
|
|
|
|
|
|
# Reference-only third-party clones — Velxio resolves these from npm at
|
|
|
|
|
# build time, so the Docker image doesn't need the upstream sources.
|
|
|
|
|
third-party/avr8js/
|
|
|
|
|
third-party/rp2040js/
|
|
|
|
|
third-party/wokwi-elements/
|
|
|
|
|
third-party/wokwi-boards/
|
2026-03-05 05:28:33 +07:00
|
|
|
|
2026-04-05 00:27:52 +07:00
|
|
|
# QEMU source & Windows builds (only prebuilt/qemu/ .so files are needed)
|
refactor: rename wokwi-libs/ → third-party/
The directory grew well beyond Wokwi-only contents: it now hosts
lcgamboa's QEMU fork (qemu-lcgamboa), Espressif's esp32-camera, the
ngspice WASM build, fritzing-parts, picowi, an alternative QEMU
(qemu-esp32), the 100_Days_100_IoT_Projects examples repo, and
Wokwi's own avr8js/rp2040js/wokwi-elements/wokwi-features/wokwi-boards.
"wokwi-libs" was misleading — half the contents have nothing to do
with Wokwi. "third-party/" is the standard convention for vendored
external dependencies.
Mechanical changes:
Path rename:
wokwi-libs/ → third-party/
update-wokwi-libs.bat → update-third-party.bat
docs/WOKWI_LIBS.md → docs/THIRD_PARTY.md
Submodule reconfiguration:
.gitmodules — 4 path= and section names updated
.git/modules/wokwi-libs/ → .git/modules/third-party/
each submodule's .git file rewired to ../../.git/modules/third-party/<name>
Reference updates (~80 files): vite.config.ts aliases, Dockerfile
COPY paths, GH Actions workflow steps, build_qemu_*.sh, all
docs/* and test/*/autosearch/* entries that mention the path,
package-lock.json file: dependencies, .gitignore patterns,
sitemap.xml + index.html SEO blurbs, scripts/generate-component-*,
.dockerignore, .idea/vcs.xml. Bulk replaced both `wokwi-libs/`
(path) and bare `wokwi-libs` (textual mentions in docs/comments).
Verified:
- npx tsc -b --noEmit produces no new errors related to these paths
- vite.config.ts aliases now point at ../third-party/avr8js etc.
- All 4 git submodules (avr8js, rp2040js, wokwi-elements,
wokwi-features) are linked under third-party/ with their
worktrees re-populated and config files referencing the new path
- `grep -r wokwi-libs` returns zero hits outside node_modules,
.vite, frontend/dist, third-party/ (upstream submodule contents),
*.pyc caches, and *.dll.pre-camera rollback binaries
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-03 10:58:57 +07:00
|
|
|
third-party/qemu-lcgamboa/
|
2026-04-05 00:27:52 +07:00
|
|
|
|
2026-03-05 05:28:33 +07:00
|
|
|
# IDE and OS
|
|
|
|
|
.vscode/
|
|
|
|
|
.idea/
|
|
|
|
|
.DS_Store
|
|
|
|
|
Thumbs.db
|
|
|
|
|
*.swp
|
|
|
|
|
|
|
|
|
|
# Git
|
|
|
|
|
.git/
|
|
|
|
|
.gitignore
|
|
|
|
|
|
|
|
|
|
# Docker files (avoid recursion)
|
|
|
|
|
docker-compose.yml
|
|
|
|
|
Dockerfile*
|
|
|
|
|
|
|
|
|
|
# Documentation (not needed in image)
|
|
|
|
|
*.md
|
|
|
|
|
doc/
|
|
|
|
|
LICENSE
|
|
|
|
|
|
|
|
|
|
# Logs
|
|
|
|
|
*.log
|