docs: cosmic green banner, branded diagram suite & README restructure#147
Merged
Conversation
Bring the README to the Rust sibling's visual bar, in PyFly's own identity
("PyFly is the green firefly of the Firefly family").
Assets (all self-contained, GitHub-sanitization-safe — no scripts/external
refs/web fonts; light/dark-mode safe):
- assets/banner.svg — dark cosmic banner: the actual logo snake + a Maven Pro
vectorized "pyFly" wordmark + green fireflies and light trails (1280x320)
- assets/{architecture,hexagonal,auto-configuration,request-lifecycle,
distributed-patterns,ecosystem}.svg — six branded, book-palette diagrams
with brand icons, measured text (guaranteed fit, no overflow) and an
automated zero-overlap check; ecosystem now includes Rust
README.md (deep restructure, prose preserved):
- banner + nav bar + table of contents
- merged "The Problem" + "What is PyFly?" into "Why PyFly?"
- elevated Quickstart; new Architecture section embedding four diagrams
(the ASCII hexagon is now a real diagram)
- distributed-patterns + ecosystem diagrams; Rust added to the table
- trimmed the stale inline changelog to a teaser; version badge
26.06.103 -> 26.06.113; added a Contributing section
Book + docs:
- book/art/cover.{svg,png} + gen_cover.py — cover title now uses the Maven
Pro wordmark (matches the banner); PNG render falls back to resvg
- CONTRIBUTING.md; assets/README.md (brand kit); assets/tools/ — the
self-contained, regenerable build tooling (Simple Icons vendored)
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
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.
Summary
Brings the PyFly README to the Rust sibling's visual bar, in PyFly's own identity — PyFly is the green firefly of the Firefly family (same firefly-in-the-dark language, recolored to Python green; the logo's green sparkles are the family's fireflies).
Banner & diagrams (
assets/)banner.svg— dark cosmic banner: the actual logo snake (cropped frompyfly-logo.png) + a Maven Pro vectorizedpyFlywordmark + green fireflies and light trails.architecture,hexagonal,auto-configuration,request-lifecycle,distributed-patterns,ecosystem— with brand icons (Python, Rust, Go, .NET, Spring, Angular, Postgres, Mongo, Redis, Kafka…), measured text (no wrapping/overflow), and an automated zero-overlap check. The ecosystem now includes Rust.Every SVG is self-contained and GitHub-sanitization-safe (no scripts / external refs / web fonts) and reads correctly in light and dark mode.
README restructure
distributed-patterns+ecosystemdiagrams embedded; Rust added to the ecosystem tableBook & docs
book/art/cover.{svg,png}+gen_cover.py— cover title now uses the Maven Pro wordmark (matches the banner); PNG render falls back to resvgCONTRIBUTING.md,assets/README.md(brand kit), andassets/tools/— self-contained, regenerable build tooling (build_brand_assets.py, Simple Icons vendored)Verification