Skip to content

Redesign the social preview card for 0.17 - #22

Merged
ehsun-sh merged 1 commit into
mainfrom
claude/project-thread-zbp052
Oct 20, 2026
Merged

ehsun-sh merged 1 commit into
mainfrom
claude/project-thread-zbp052

Conversation

@ehsun-sh

Copy link
Copy Markdown
Owner

Requested by Ehsan · project thread

Before: the card shown when the repository or site is linked had the name, a tagline, three fact lines and a single constellation. It said nothing about the studio, the guided examples or the desktop app that landed since.

After: the card leads with "Build optical links. See every signal." (the headline from the promo videos and thumbnails), shows 77 components, 49 guided examples and Desktop & Python as chips, a footer with v0.17.0 · pip install maiman · maimanstudio.com, and two real instruments side by side: the shipped 10 Gb/s direct-detection eye (Q 16.9) and the coherent 16-QAM constellation (EVM 7.4 %).

new card

How: docs/render_og_cover.py now also runs export_ui_data.ook_link() at a finer eye resolution, and reads the component count from manifests(), the example count from examples/maiman/*.maiman and the version from the package, so a release that adds blocks or examples updates the card on the next run. Same 1200x630 at 2x, same headless-Chrome render, same graphite ground and port-colour rule.

The GitHub social preview itself is uploaded by hand in the repository's Settings → General → Social preview, so assets/og-cover.png needs uploading there after merge.


Generated by Claude Code

The card now leads with what the studio is for and what it ships: the
headline from the promo material, counted components and guided
examples, and two real instruments, the shipped direct-detection eye
beside the coherent constellation. The counts and version are read from
the engine, the examples folder and the package, so the card stays true
as releases add blocks.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GyUCJcfv1dHWHKVZ8RJuSM
@ehsun-sh ehsun-sh self-assigned this Oct 20, 2026
@ehsun-sh
ehsun-sh marked this pull request as ready for review October 20, 2026 14:10
@ehsun-sh
ehsun-sh merged commit 7e65715 into main Oct 20, 2026
5 checks passed
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.

2 participants