Development

Contributor and architecture content. If you are an operator running labs, the rest of this site is what you want — this section assumes you are reading or modifying the codebase.

Start here

• Architecture overview — the big picture: services, data flow, where state lives.
• Backend — FastAPI app structure, services, the EVE-NG importer module.
• Frontend — SvelteKit app structure, the canvas, design system.

Specific subsystems

• Node add/edit workflow — modal + backend contract for creating and editing nodes.
• Design system adoption — how the bundled design tokens propagated through the app.
• Deployment contract — what every host-side install must satisfy, what may not change without a contract bump.

CI

• Self-hosted runner — how the GitHub Actions self-hosted runner is set up.
• Ubuntu 26.04 beta ISO — base image notes for the CI runner.
• fy-lab validation — the in-house validation lab.

Contributing

See CONTRIBUTING.md in the repo root for the canonical contributor guide (it lives at the root so GitHub's "Open a PR" flow surfaces it). Local mirror →.