velxio/docs
David Montero Crespo 28d9cbc490 chore(oss): drop dead auth/DB dependencies from OSS image
After Phase 4 of the OSS / pro split, the OSS code base imports zero
auth/DB modules (verified with grep across backend/app/). But the
requirements.txt + config.py + .env.example + docs still listed
SQLAlchemy, aiosqlite, JWT/bcrypt, OAuth, SECRET_KEY etc. as if they
were live. Self-hosters running `pip install -r requirements.txt`
were pulling ~30 MB of packages the code never imports.

Changes:

* backend/requirements.txt — drop sqlalchemy, greenlet, aiosqlite,
  python-jose, passlib[bcrypt], bcrypt, authlib, email-validator,
  python-multipart. Keep fastapi, uvicorn, websockets, pydantic,
  pydantic-settings, httpx, mcp, esptool, wasmtime — everything OSS
  actually uses.
* backend/app/core/config.py — Settings reduced to FRONTEND_URL only.
  Comment explains the overlay path that adds the rest at Docker
  build time.
* backend/.env.example — same trim: only FRONTEND_URL, with a comment
  explaining why this file is almost empty.
* README.md — "Auth & Project Persistence" section rewritten to
  describe .vlx export/import. Env-var table reduced to a single row.
  Stack table updated: no SQLAlchemy, no JWT, persistence = .vlx
  files.
* CLAUDE.md — intro line updated (Auth: None, persistence: .vlx).
  Key-file-locations rewritten to list the OSS-stateless backend +
  the new lib/proRoutes / proSession / proSaveAction seams, with an
  explicit "removed in the split" note pointing to velxio-prod.
  Stores section drops useAuthStore (overlay-only now). Backend
  gotchas drop the bcrypt + email-validator + model-import notes.
  Implemented-features list replaces "Auth + URL persistence + user
  profile" with portable .vlx export/import.
* docs/ESP32_EMULATION.md — two `docker run` examples dropped the
  `-e SECRET_KEY=...` arg (no longer needed).

OSS build verified end-to-end (285 SEO pages prerender, 20 stateless
routes, zero sqlalchemy imports).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 17:06:27 -03:00
..
examples Translate Spanish docs to English and add SEO-optimised URL routing for documentation 2026-03-11 18:46:42 +00:00
img/boards Refactor code structure for improved readability and maintainability 2026-03-16 14:28:16 -03:00
wiki refactor: rename deploy/ → docker/ (container build, not host deploy) 2026-05-04 00:05:55 -03:00
ARCHITECTURE.md refactor: rename wokwi-libs/ → third-party/ 2026-05-03 00:58:57 -03:00
BUILD-QEMU.md docs: BUILD-QEMU.md + 'Build QEMU from source' docs section 2026-05-14 05:44:10 +02:00
CUSTOM_CHIPS.md Add ESP32 chip demos and comprehensive tests for I2C, SPI, and UART interactions 2026-04-28 19:24:39 -03:00
ESP32C3_WIFI_BLUETOOTH.md refactor: rename wokwi-libs/ → third-party/ 2026-05-03 00:58:57 -03:00
ESP32_EMULATION.md chore(oss): drop dead auth/DB dependencies from OSS image 2026-05-14 17:06:27 -03:00
ESP32_WIFI_BLUETOOTH.md refactor: rename wokwi-libs/ → third-party/ 2026-05-03 00:58:57 -03:00
MCP.md Merge doc/ into docs/ — eliminate duplicate documentation folders 2026-03-11 17:03:51 +00:00
MICROPYTHON_IMPLEMENTATION.md feat: add comprehensive MicroPython implementation documentation for RP2040, ESP32, ESP32-S3, and ESP32-C3 boards 2026-03-29 23:50:55 -03:00
PICO_W_WIFI_EMULATION.md refactor: rename wokwi-libs/ → third-party/ 2026-05-03 00:58:57 -03:00
RASPBERRYPI3_EMULATION.md Refactor code structure for improved readability and maintainability 2026-03-16 14:28:16 -03:00
RISCV_EMULATION.md refactor: rename wokwi-libs/ → third-party/ 2026-05-03 00:58:57 -03:00
RP2040_EMULATION.md refactor: rename wokwi-libs/ → third-party/ 2026-05-03 00:58:57 -03:00
SETUP_COMPLETE.md refactor: rename wokwi-libs/ → third-party/ 2026-05-03 00:58:57 -03:00
THIRD_PARTY.md feat(components): swap BMP280 + ATtiny85 to fritzing art 2026-05-08 23:06:44 -03:00
analytics.md feat: add GA4 key events tracking (run_simulation, open_example, create_project, compile_code, visit_github) 2026-03-12 22:02:24 +00:00
components.md Create documentation page accessible at /docs 2026-03-11 15:56:06 +00:00
emulator.md Create documentation page accessible at /docs 2026-03-11 15:56:06 +00:00
getting-started.md Refactor code structure for improved readability and maintainability 2026-03-16 14:22:23 -03:00
img1.png Merge doc/ into docs/ — eliminate duplicate documentation folders 2026-03-11 17:03:51 +00:00
img2.png Merge doc/ into docs/ — eliminate duplicate documentation folders 2026-03-11 17:03:51 +00:00
img3.png Merge doc/ into docs/ — eliminate duplicate documentation folders 2026-03-11 17:03:51 +00:00
img4.png Merge doc/ into docs/ — eliminate duplicate documentation folders 2026-03-11 17:03:51 +00:00
img5.png Refactor code structure for improved readability and maintainability 2026-03-16 18:31:46 -03:00
img6.png Refactor code structure for improved readability and maintainability 2026-03-23 23:24:14 -03:00
intro.md Add ESP32 chip demos and comprehensive tests for I2C, SPI, and UART interactions 2026-04-28 19:24:39 -03:00
roadmap.md Create documentation page accessible at /docs 2026-03-11 15:56:06 +00:00