Skip to content

docs: gate-mark branding — logo assets, Connect animation, banner + README - #48

Merged
johnnyhuy merged 6 commits into
mainfrom
docs/logo-motion-connect
Nov 10, 2026
Merged

johnnyhuy merged 6 commits into
mainfrom
docs/logo-motion-connect

Conversation

@johnnyhuy

Copy link
Copy Markdown
Contributor

Summary

Replaces the flame branding with the gate mark (round-4 foot-plain) across the repo, ships the full logo/animation asset set, and revises the README against the code it describes.

Logo assets (docs/assets/logo-explore/)

  • mark.{dark,light}.svg — the arch + orange foot dot mark alone
  • logo.{dark,light}.svg — full lockup with the "OpenGateway" wordmark (Outfit SemiBold, outlined paths from wordmarks.json — no font dependency at render time)
  • logo.gif — the Connect animation (key clicks down/up, gate unlocks, leg latches) cropped square around the mark
  • banner.svg + logo.py — banner source and the generator for everything above

The Connect animation (motion/)

The hero variant: the key clicks down and up inside the ring, the ring unlocks into the arch, the key exits to the foot, and the right leg latches closed — with synthesised sound rendered from the same cue engine as the live preview page. python3 motion.py regenerates all 13 variants; python3 logo.py && magick banner.svg ../banner.png regenerates the branding.

Caught and fixed a fill-mode bug during render: the latch animation used backwards, so the leg vanished after its animation finished. Now both — verified holding on the final frame.

Banner + README

  • docs/assets/banner.png rebuilt at the same 1792x592 from banner.svg: gate mark + wordmark on the dark grid
  • README hero shows the new banner plus the animated logo
  • README revisions:
    • dropped the leaked internal positioning line. editor note from the Bifrost quote
    • corrected the test count (56 → 60 collected) in Philosophy
    • fixed the stale Project Status claim — virtual keys, budgets, and Postgres-backed persistence ship today (the roadmap already said so; mojo_bridge/db.py exists)
    • documented the brand assets in the repository structure and documentation table

Verification

  • Banner/lockup/mark rendered and visually checked in dark + light themes
  • GIF frame count 97 @ 440x440, plays the full Connect sequence
  • pytest --collect-only confirms 60 tests
  • Makefile targets referenced by the README all exist

Co-authored-by: opencode-agent[bot] <219766164+opencode-agent[bot]@users.noreply.github.com>

johnnyhuy and others added 6 commits November 9, 2026 02:11
Adds docs/assets/logo-explore/motion: the animation source (motion.py),
dark/light SVGs for all variants, synthesised cue WAVs, MP4/GIF renders,
and a local preview page (index.html).

Connect is the hero variant: the key clicks down and up inside the ring,
the ring unlocks into the arch, the key exits to the foot, and the right
leg latches closed at the end. Latch stays as the standalone open/close
status loop. All outputs regenerate with `python3 motion.py`.

Co-authored-by: opencode-agent[bot] <219766164+opencode-agent[bot]@users.noreply.github.com>
Adds the actual logo assets to docs/assets/logo-explore and rewires the
README imagery to them:

- logo.py generates mark.{dark,light}.svg (round-4 foot-plain mark),
  logo.{dark,light}.svg (Outfit SemiBold lockup from the outlined
  wordmarks.json paths - no font dependency), and banner.svg
- logo.gif is the Connect animation cropped square around the mark
- docs/assets/banner.png rebuilt from banner.svg at the same 1792x592,
  gate mark + OpenGateway wordmark on the dark grid, replacing the flame
- README hero now shows the new banner plus the animated logo

Co-authored-by: opencode-agent[bot] <219766164+opencode-agent[bot]@users.noreply.github.com>
- drop the leaked "internal positioning line" editor note from the
  Bifrost quote
- correct the test count (56 -> 60 collected) in Philosophy
- fix the stale Project Status claim: virtual keys, budgets, and
  Postgres-backed persistence ship today, with in-memory fallback
- document the new brand assets in the repository structure and the
  documentation table

Co-authored-by: opencode-agent[bot] <219766164+opencode-agent[bot]@users.noreply.github.com>
The README was 500 lines of showcase mixed with reference material.
It is now 265 lines that sell the project; the reference lives in docs.

- drop the Roadmap (stale the week it is written) and the repository
  tree from the README
- move the env var table, ROUTES_JSON routing, cost caps, provider
  fallback, in-binary TLS, and the mock-upstream demo to the new
  docs/configuration.md, linked from the hero nav and docs table
- move the repository layout to CONTRIBUTING.md where developers look
- cut the Integrations table (the Drop-in section already names the SDKs)
- fix the architecture diagram: it labeled FastAPI as default, which
  contradicted ADR-003 and the rest of the README
- fix the same stale claim in CONTRIBUTING.md
- evergreen phrasing: no test counts, no "next milestone" language

Co-authored-by: opencode-agent[bot] <219766164+opencode-agent[bot]@users.noreply.github.com>
The hero showed the lockup twice: a static banner plus the animated
mark below it. Now it is one slim banner (1792x360) with the Connect
animation playing on the mark beside the still wordmark.

- logo.py composes banner.svg (static, settled lockup) and
  banner.anim.svg (the Connect keyframes and mark extracted from
  motion.py's output, so the animation has one source)
- docs/assets/banner.gif is the browser-captured encode (103 frames,
  85 KB), replacing the two hero images
- static banner.png kept at the same slim size for non-animated uses

Co-authored-by: opencode-agent[bot] <219766164+opencode-agent[bot]@users.noreply.github.com>
ASCII box art only renders in fixed-width viewports and rots the moment
a box label changes. GitHub renders mermaid natively.

- README Architecture and docs/architecture.md request flow: flowchart
  TD with the same layers and edge annotations
- Mojo to Python boundary: sequenceDiagram, which now shows the call
  order the ASCII twin-column sketch only implied
- Deployment shapes: four independent options with shell commands are a
  table, not a relationship diagram, so they become one (mermaid nodes
  mangle command text)
- the CONTRIBUTING.md repository tree stays a code block: it is a file
  listing, and mermaid has no file-tree type

Every mermaid block was validated through Kroki before landing.

Co-authored-by: opencode-agent[bot] <219766164+opencode-agent[bot]@users.noreply.github.com>
@johnnyhuy
johnnyhuy merged commit 50ce522 into main Nov 10, 2026
13 checks passed
@johnnyhuy
johnnyhuy deleted the docs/logo-motion-connect branch November 10, 2026 13:30
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