406b6ac144f2b1c2368c651465552a0b2f5ee712
A sweep against the code. Removed as resolved: the worker pool's `_running` is keyed by (run, node) now, `WorkItem.kind` documents only the three kinds that exist, `routeTree.gen.ts` matches its generator, and the host's Node is well past the version the Vite 7 note was about. Removed as disproved: the collector's redelivery branch is reachable — Redis reclaims an entry this process is still running. Corrected: the demo places six of the fifteen node types, not thirteen — the count was the widget types. Narrowed to what is left: the header/config sync now covers settings but only on an untouched scaffold and only one way; a declared flow input is what the dashboard-input node asked for; the flow boundary already refits the canvas where node ports do not. The Playwright hazard is not resolved — both names still resolve to production — and the fix as written is incomplete: `VITE_API_URL` has to be overridden to `http://` or every setup call fails the TLS handshake. Also: one `asText` instead of two, and the queue docstring no longer refers to a node item that never existed. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01NUb8YpL2s3gmN9WTACTt4q
Fluksio App
Fluksio has the goal to build a revolutionary system to tackle any sort of automation challenge.
The core of Fluksio: a node-based, test-driven automation software built to scale. This
repo holds the FastAPI backend, the flow engine, and the dashboard SPA. It is served on
app.${DOMAIN} (SPA) and api.${DOMAIN} (API); the marketing site lives in the sibling
index repo.
Layout
backend/ FastAPI + SQLModel + Alembic + Postgres
app/flow/ the flow engine (nodes, pipeline, state backends, controller)
frontend/ React 19 + TanStack Router + Tailwind 4 + shadcn/ui
docker/ compose.yml → compose.dev.yml → compose.local.yml (+ compose.traefik.yml)
scripts/ generate-client.sh, test.sh
Getting started
Normally driven from the workspace root (make init once, then make dev). Standalone:
make install # uv sync + bun install
make dev-utils # db, adminer, proxy, mailcatcher, prestart only
make dev-backend # FastAPI on :8000, hot reload
make dev-frontend # Vite on :5173
make test # pytest + Playwright
make lint # ruff + mypy + biome
make generate-client # regenerate the frontend SDK from the OpenAPI schema
make help lists every target.
Documentation
ROADMAP.md— strategy and feature recordNOTEPAD.md— deferred work and findingsDESIGN.md— points at the workspace root'sDESIGN-GUIDELINES.mddocs/architecture/in the siblingdocsrepo — the requirement sources
Languages
Python
54%
TypeScript
42.6%
CSS
1.9%
HTML
0.5%
JavaScript
0.5%
Other
0.3%