Skip to content

docs: add Mermaid architecture diagram and script reference table#1

Open
Prometheus1400 wants to merge 1 commit into
SamuelDixxon:mainfrom
Prometheus1400:main
Open

docs: add Mermaid architecture diagram and script reference table#1
Prometheus1400 wants to merge 1 commit into
SamuelDixxon:mainfrom
Prometheus1400:main

Conversation

@Prometheus1400

Copy link
Copy Markdown

Summary

Added a Mermaid architecture diagram and script reference table to help visualize and understand the multi-device sync ecosystem.

Changes

  • Mermaid Diagram: Visual flowchart showing:

    • Device fleet (S23+, Pixel 9a, ZFlip7)
    • GitHub Cloud as the "Source of Truth"
    • Core scripts (~/.shortcuts/) and their relationships
    • Hidden engine components (.hidden/)
    • Bidirectional sync flow with rsync --delete and git reset --hard
  • Script Reference Table: Quick lookup for what each script does and which direction it syncs

Why

The original README described the components but didn't provide a holistic view of how everything connects. The diagram makes it immediately clear:

  • How the 3 phones interact with GitHub
  • Which scripts push vs pull
  • The role of the hidden data engine

Mermaid diagrams render natively in GitHub markdown, so no external tooling needed.

- Add visual system architecture diagram showing device fleet, GitHub cloud,
  core scripts, and hidden engine components
- Include script reference table with purpose and sync direction
- Makes the multi-device sync ecosystem easier to understand at a glance
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant