docs(readme): replace header with "Phase platform" diagram - #1021
Merged
Merged
Conversation
…ssentials
The README opened with a logo, repo links, a tagline, a demo MP4, a
features table, a CLI help dump, getting-started, self-hosting and SDK
sections that had drifted from the product and duplicate the docs.
Replace the lot with a single theme-aware diagram, a static SVG port of
the docs landing-page "Phase at a glance" sheet linked to docs.phase.dev,
and keep only the Community vs Enterprise, Security and Contributing
sections.
img/phase-platform-{light,dark}.svg are fixed-theme renders selected via
<picture> + prefers-color-scheme. The mono face (JetBrains Mono latin
subset, SIL OFL 1.1) and every brand mark are embedded so GitHub draws
the sheet identically on every platform. They are generated by a local
skill (phase-platform-diagram); regenerate rather than hand-edit.
nimish-ks
force-pushed
the
readme-update-26
branch
from
September 12, 2026 13:30
491472d to
6275485
Compare
nimish-ks
changed the title
nimish-ks
marked this pull request as ready for review
September 12, 2026 13:36
GitHub Mobile renders README images with a native rasteriser that fails
on the platform SVGs (embedded font, <symbol>/<use>), so the diagram was
blank in the Android app. Add img/phase-platform-{light,dark}.png, 2×
rasters of the same SVGs, and order the <picture> sources so phones and
the app get a raster while desktop browsers keep the SVG:
1. PNG sources for (max-width: 640px), dark and light
2. SVG sources for prefers-color-scheme with type="image/svg+xml"
3. the light PNG as the plain <img> fallback
Generated by the same local skill as the SVGs.
rohan-chaturvedi
approved these changes
Sep 16, 2026
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.
Replaces the README header (logo, repo links, tagline, demo video, features table, CLI help dump) and the getting-started, self-hosting and SDK sections with a single theme-aware Phase platform diagram, a static SVG port of the docs landing-page "at a glance" sheet, linked to docs.phase.dev. The Community vs Enterprise, Security and Contributing sections stay as they were.
img/phase-platform-light.svgandimg/phase-platform-dark.svgare picked by<picture>+prefers-color-scheme. Fonts and brand marks are embedded, so GitHub draws them identically on every platform. GitHub Mobile's native image renderer can't draw the SVGs, soimg/phase-platform-{light,dark}.png(2× rasters of the same files) serve viewports up to 640px wide and act as the plain<img>fallback. All four are generated by a local skill rather than checked-in tooling, so the repo only carries the images.Light
Dark