docs: refresh README presentation and onboarding

[nonnil]

The README led with MediaRemote implementation details before showing what the lighting project does or how to try it. Reorganise it around the visible result, an original concept illustration, and a download → check → run path, with the existing technical material retained in docs/guide.md.

Add release/CI/platform/licence badges, readable effects and compatibility tables, troubleshooting links, and concrete contribution routes. Keep unverified player support and hardware calibration limits explicit. Download instructions point to the published v0.1.0 release, distinguish source-build requirements, and stop on checksum failure. Readers of packaged releases can follow an online documentation link.

docs/readme-design.md records the presentation patterns studied in Glow, uv, Starship, and CAVA. The SVG is clearly labelled as a concept illustration; no hardware footage or new compatibility validation is claimed.

Validation: GitHub Markdown rendering; light/dark and narrow-width visual checks; local links and heading anchors; SVG XML; shell syntax for all command blocks; preservation of the original technical sections; published release download, SHA-256 verification, and CLI help/version checks. git diff --check passes. Documentation only; no Rust code or release workflow changes.

Summary by CodeRabbit

• Documentation
  • Replaced the README with a shorter introduction and setup guide, including system requirements, installation, permissions, operating modes, and troubleshooting.
  • Added a technical guide with detailed usage, compatibility, privacy, and development information.
  • Added design notes covering onboarding, presentation, and future documentation plans.

[coderabbitai]

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 0a43b461-82fd-4535-a6d8-2e3eb3c417d1

📥 Commits

Reviewing files that changed from the base of the PR and between b4f99e4 and 00f147b.

⛔ Files ignored due to path filters (1)

• docs/assets/chroma-hero.svg is excluded by !**/*.svg

📒 Files selected for processing (3)

• README.md
• docs/guide.md
• docs/readme-design.md

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.

---

📝 Walkthrough

Walkthrough

The README is now a shorter introduction and setup guide. A new technical guide contains detailed usage and implementation information. New design notes record presentation references, proposed content, media plans, and an evaluation approach.

Changes

Project documentation

Layer / File(s)	Summary
README introduction and presentation README.md, docs/readme-design.md	The README adds a product introduction and feature overview. The design notes record presentation references, proposed README content, planned media, and an evaluation approach.
Release and quick-start instructions README.md	The README documents requirements, release downloads and checksum verification, permission notes, CLI quick-start commands, and login installation.
Operation and technical reference README.md, docs/guide.md	The README summarizes effects, compatibility, troubleshooting, source builds, and contributions. The new guide documents setup, operation, session selection, logging, privacy, implementation, development, and release procedures.

Priority: ⬇️ Low

Estimated code review effort: 2 (Simple) | ~12 minutes

Change: Other

Merge Risk: ⚪ Minimal · up to 00f14

The README retains a usable setup path: command examples match the CLI, and download and checksum steps match the release workflow. No actionable mismatch is established, so this documentation-only change is ready to merge.

Architecture Summary

Architecture risk: 🔵 Low · up to 00f14

The change affects 2 systems.

Changed systems: docs, README.md

Architecture concerns
No architecture-level concerns identified.

Review details

Systems and components

• observed — docs (service) was modified; 2 changed files map to changed impact.
• observed — README.md (service) was modified; 1 changed file maps to changed impact.

Before / after behavior

• observed — Modified behavior in README.md: Replaces the technical project overview and architecture diagram with a centered product introduction, badges, navigation links, and an illustration; directs release-archive readers to the GitHub README and guide.
• observed — Modified behavior in README.md: Adds a brief feature overview covering artwork-derived colour, audio-reactive effects, supported Now Playing integration, local processing, and terminal or login-worker use.
• observed — Modified behavior in README.md: Adds requirements and release-download instructions, including the v0.1.0 universal archive, checksum verification commands, and the ad-hoc-signing notice. Replaces the former standalone download section.
• observed — Modified behavior in README.md: Adds quick-start instructions for probe, status, reactive run, static run, and login installation, with the relevant HID and system-audio permission notes. The README no longer contains the previous detailed permission procedures, permission retry descriptions, LaunchAgent setup, or uninstall instructions.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately summarizes the primary change: reorganizing the README presentation and onboarding while moving technical details into documentation.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}