# Documentation Index


This index is a discovery map for deeper tasks, providing entry points to
detailed documentation for the IoT2050 project. Each document covers a
specific domain without duplicating procedural steps.

For a high-level overview and quick start, see the main [`README.md`](../README.md)
in the repository root.

| Topic | File | TL;DR |
|-------|------|-------|
| Layer architecture | [layer-architecture](layer-architecture.md) | Modular split of core vs feature/variant layers. |
| Build configuration (menu & manual) | [build-config](build-config.md) | TUI vs manual fragment chaining, Example/Dev auth profiles, and local verification. |
| First-boot onboarding details | [firstboot-onboarding.md](firstboot-onboarding.md) | End-to-end onboarding control flow, gateway topology, and runtime handoff. |
| Cockpit integration architecture | [cockpit-architecture.md](cockpit-architecture.md) | Package, navigation, and privilege-boundary rules for IOT2050 Cockpit pages. |
| Firmware Center | [firmware-center.md](firmware-center.md) | Provider architecture, IPC, staging, security boundaries, and maintenance guidance. |
| Device Admin | [iot2050-device-admin](iot2050-device-admin.md) | HTTPS certificate and private-key installation guidance. |
| Maintenance & operations | [maintenance](maintenance.md) | Flashing, networking, first-boot credentials, eMMC install, and firmware operations. |
| Fragment catalog (advanced) | [fragment-catalog](fragment-catalog.md) | Reference for advanced fragments (real-time, reproducibility, etc.). |
| SDK | [sdk](sdk.md) | Build and use cross SDK (tarball & Docker). |
| SWUpdate A/B images | [swupdate](swupdate.md) | Build, flash, and update dual-rootfs images; confirm updates safely. |
| QEMU emulation | [qemu](qemu.md) | Build and run emulated image; limitations & debug tips. |