diff --git a/README.md b/README.md
index 6c8facf..0379a5c 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,99 @@
-# Canvas Pilot
+
+
+
+Canvas Pilot
+Compose your screen layout. Frame every layer. Bring it to the switcher.
-
-
-
+
+ Get started ·
+ Read the manual ·
+ Get templates ·
+ Report an issue
+
-Arrange screen layers, exchange geometry, and review transfers to Analog Way Midra
-and Aquilon presentation switchers. An independent project, not affiliated with Analog Way.
+Canvas Pilot is a desktop layout editor for presentations and live events. Arrange
+slides, cameras and other content as layers on a screen, give them precise sizes
+and positions, and crop each picture into place. Prepare everything offline, exchange
+layouts with drawing tools, or connect to a supported **Analog Way Midra or Aquilon**
+to load and send layer geometry.
+
+Canvas Pilot prepares the layout; your presentation switcher renders the live output.
+You can use the editor and file exchange without any connected equipment.
+
+
+[](docs/canvas-pilot/guide/quickstart.md)
+
+*Slides + Presenter on a Full HD canvas. This capture predates the Canvas Pilot
+rename and still shows the former “Midra Layout” name.*
+
+## From an idea to a screen layout
+
+1. **Set the stage.** Choose your canvas size, start with the example layout, or
+ import geometry. Add a reference image to position layers against your design.
+2. **Arrange and frame.** Drag, resize, snap and align layers. Enter exact pixel
+ measurements, organize alternatives in folders, and adjust the crop visually.
+3. **Save or exchange.** Keep an editable project, export a layout for another tool,
+ or start from the supplied Full HD and 4K templates.
+4. **Transfer when ready.** Connect to a supported device, review layer mappings
+ and the Preview/Program destination, then explicitly load or send. Ordinary
+ editing stays local.
+
+[Walk through your first layout →](docs/canvas-pilot/guide/quickstart.md)
+
+## Tools for getting the picture right
+
+| Arrange the screen | Frame the content | Work with the device |
+| --- | --- | --- |
+| Exact sizes and positions | Visual crop, zoom and offset | Load existing layer geometry |
+| Snapping, guides and alignment | Reference images and input stills | Review layer-to-device mappings |
+| Multi-selection and group resizing | Advanced layer fit and Midra masks | Send selected, folder or all layers |
+| Folders, lock/visibility and undo/redo | Saved projects and recovery | Update changed parameters efficiently |
+
+
+See the crop workspace
+
+
+
+
+Adjust the picture inside its layer while keeping the layout in view.
+See [formats, crop and precision](docs/canvas-pilot/guide/formats-and-crop.md)
+for the available modes and device limitations. This capture also predates the rename.
+
+
+
+## Bring your layout with you
+
+Exchange geometry through **SVG, draw.io, JSON, CSV, DXF, DWG, HTML, PPTX, Figma FIG,
+FigCraft and Illustrator AI**. Import review lets you choose what to apply to your
+layers; supported formats can also carry optional project metadata.
+
+[**Download all starter templates**](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/raw/branch/main/docs/templates/canvas-pilot/canvas-pilot-all-templates.zip)
+· [Browse individual formats](docs/templates/canvas-pilot/README.md)
+· [Import/export guide](docs/canvas-pilot/guide/files.md)
+
+Format capabilities vary. Native vendor codecs are included in the default build;
+Illustrator AI requires the separate VectorCraft CLI. **SVG is the recommended
+Illustrator exchange format.** Keep your editable project alongside geometry exports.
+
+## Supported switchers
+
+| Adapter | Recorded validation | Details |
+| --- | --- | --- |
+| **Midra 4K** | Eikos 4K, firmware 3.3.10; hardware protocol checks | [Device checks and limits](docs/canvas-pilot/device-check.md) |
+| **Aquilon / LivePremier** | Standalone AQL Cmax 6.2.x; emulator acceptance on 6.2.79 | [Compatibility and support boundaries](docs/canvas-pilot/aquilon-compatibility.md) |
+
+Support depends on model, firmware and feature. Aquilon physical-output acceptance
+remains outstanding; the recorded profile does not imply support for every Aquilon
+configuration. See the [connection and transfer guide](docs/canvas-pilot/guide/device.md)
+before using a device.
+
+Interested in another switcher? [See the adapter candidates](docs/canvas-pilot/presentation-switcher-adapters.md)
+and [open a request](https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot/issues).
+Development requires **protocol documentation and a usable emulator/simulator**.
+
+## Get started
+
+Build and run from source with a current stable Rust toolchain and a graphical desktop:
```sh
git clone https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot.git
@@ -13,15 +101,41 @@ cd canvas-pilot
cargo run --locked
```
-Use a current stable Rust toolchain. Linux desktop builds need the usual X11/Wayland
-and GTK development libraries. Python tooling requires Python 3.11+.
+Linux builds need the X11/Wayland and desktop development libraries used by egui/rfd.
+Python 3.11+ is needed for the development helpers. See [development and checks](docs/development/README.md)
+and [release preparation](docs/development/releases.md) for build and packaging details.
-[Full manual](https://books.dandaedre.com/manuals/canvas-pilot/) ·
-[User guide](docs/canvas-pilot/guide/README.md) ·
-[Templates](docs/templates/canvas-pilot/README.md) ·
+Then follow the [first-layout walkthrough](docs/canvas-pilot/guide/quickstart.md),
+or open the [advanced guide](docs/canvas-pilot/guide/README.md) for the full controls.
+
+## Find your way around
+
+[**Full manual**](https://books.dandaedre.com/manuals/canvas-pilot/) ·
+[Advanced guide](docs/canvas-pilot/guide/README.md) ·
[Changelog](docs/canvas-pilot/changelog.md) ·
-[Development](docs/development/README.md) ·
[Tasks and stretch goals](docs/canvas-pilot/plan.md) ·
-[Documentation index](docs/README.md)
+[All documentation](docs/README.md)
-Originally part of [beffroi-tools](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools); see [migration notes](docs/development/migration.md).
+For bug reports, include your OS, application version, steps to reproduce and,
+for device issues, the model and firmware. Contributors can start with the
+[development guide](docs/development/README.md) and [file/device contracts](docs/interfaces/README.md).
+
+
+Build status
+
+The badges below become available after the standalone Jenkins pipeline publishes
+its first results. See [CI setup and local checks](docs/development/ci.md).
+
+
+
+
+
+
+
+
+
+---
+
+[MIT licensed](LICENSE). Independent software, not affiliated with Analog Way.
+Originally part of [beffroi-tools](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools);
+[earlier history and migration notes](docs/development/migration.md) remain available.
diff --git a/docs/canvas-pilot/changelog.md b/docs/canvas-pilot/changelog.md
index 1e6db0a..728c993 100644
--- a/docs/canvas-pilot/changelog.md
+++ b/docs/canvas-pilot/changelog.md
@@ -4,6 +4,11 @@
## Unreleased
+- Redesigned the repository README with an illustrated introduction, layout workflow,
+ feature overview, format/device guidance and direct setup, template and help links.
+ Existing screenshots are identified as captures from before the rename.
+
+
- Audited all 165 migrated project files; task lists, stretch goals, advanced guide,
screenshots, templates and fixtures were retained. Expanded agent guidance and
documentation navigation, and included the transferred checklists/research in