docs: animated architecture diagrams (SVG, brand style) - #2
Merged
Conversation
Five self-contained, dependency-free animated SVG diagrams in the dark /
monospace / blue-accent house style, explaining how camera_pro works:
- architecture-ffi-flow — a frame's path across the one Dart↔native FFI hop
- capability-passport-tier — Supported/NotSupported → Full/Standard/Basic
- visual-aids-pipeline — GPU/CPU dispatch → the five overlays
- digital-controls — the "no sensor controls → still DSLR" trick
- web-puredart-split — the conditional export that keeps dart:ffi off web
- Gallery: doc/diagrams/README.md. Hero diagram embedded in the main README
("Architecture at a glance") and ARCHITECTURE.md.
- SVGs degrade gracefully: nodes are visible without CSS animation (fill-mode
both, no base opacity:0), so renderers that strip animation still show the
full diagram. They animate on GitHub.
- .pubignore now excludes doc/ entirely (diagrams + screenshots are
GitHub-facing; pub.dev resolves README images from the repo). Archive stays
~376 KB.
Docs/assets only — no code change.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…ool) Same house style, extending the set to ten: - capture-paths — capturePhoto → PNG / linear-DNG (EXIF) / video - simd-arch — NEON · SSSE3 · scalar, bit-exact (+ the honest bench) - burst-bracket — captureBurst(5) ≈1.2s and −2/0/+2 EV with measured YAVG - ci-matrix — native.yml across macOS / Ubuntu / Windows / web, green - buffer-pool-ring — the lock-free, cache-aligned, GC-free frame ring All self-contained SVG, well-formed (xmllint), graceful-degrading (visible without CSS animation), added to the doc/diagrams gallery. Docs/assets only. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
sayed3li97
pushed a commit
that referenced
this pull request
Jul 6, 2026
Builds on the hero (architecture-ffi-flow) already on main from #2 and places the other nine at the section each explains, turning the README into a visual tour — all in the dark / monospace / blue-accent house style: - Feature status (intro) → capability-passport-tier - Manual controls → digital-controls - Visual aids → visual-aids-pipeline - Capture → capture-paths + burst-bracket - Web → web-puredart-split - Verified this build → ci-matrix - Measured performance → simd-arch + buffer-pool-ring README-only (+47). The SVGs already landed on main via #2; this just embeds them. Rebased onto current main after #1/#2 merged, so it applies cleanly.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Five animated explanatory diagrams in the dark / monospace / blue-accent house style, matching the diagrams on sayedalialkamel.com. Docs/assets only — no code change.
Diagrams (
doc/diagrams/)architecture-ffi-flow.svgcapability-passport-tier.svgSupported/NotSupported→ Full / Standard / Basicvisual-aids-pipeline.svgdigital-controls.svgCameraTier.full" trickweb-puredart-split.svgdart:ffi/dart:iooff webWiring
doc/diagrams/README.md..pubignorenow excludesdoc/(diagrams + screenshots are GitHub-facing; pub.dev resolves README images from the repo). Archive stays ~376 KB.Notes
🤖 Generated with Claude Code