Skip to content

feat(branding): add a README banner - #16

Merged
deniscuciuc merged 3 commits into
mainfrom
chore/branding-and-schema
Sep 10, 2026
Merged

deniscuciuc merged 3 commits into
mainfrom
chore/branding-and-schema

Conversation

@deniscuciuc

Copy link
Copy Markdown
Owner

The README is the entire npm listing — npm has no package icon field — so this is the only branding surface the package has.

Two details that matter, because both would silently render nothing:

  • Plain CommonMark image syntax, not a centred <p> wrapper. npm sanitises raw HTML in READMEs, so the wrapper isn't reliable.
  • Absolute raw.githubusercontent.com URL. Relative paths don't resolve once the package is installed from the registry.

The banner is 1280px wide, quantised to a 128-colour palette with dithering — around 250 KB instead of the 1.3 MB source, with no visible banding (I compared crops before committing).

Also folds in a one-line fix: biome.json still pointed at the 2.3.11 schema after the bump to 2.5.12, which biome reports as an info diagnostic on every run. Bundled here rather than spending a separate PR on it.

The banner appears on GitHub immediately and on npm from the next publish.

biome.json still pointed at the 2.3.11 schema after the bump to 2.5.12, which
biome itself reports as an info diagnostic on every run.
The README is the entire npm listing — npm has no package icon field — so this
is the only branding surface the package has.

Plain CommonMark image syntax with an absolute raw.githubusercontent.com URL:
relative paths do not resolve once the package is installed from the registry,
and npm sanitises raw HTML, so a centred <p> wrapper is not reliable.

The banner is 1280px wide, quantised to a 128-colour palette with dithering —
around 250 KB rather than the 1.3 MB source, with no visible banding.
@deniscuciuc
deniscuciuc merged commit 8356ac6 into main Sep 10, 2026
4 checks passed
@deniscuciuc
deniscuciuc deleted the chore/branding-and-schema branch September 10, 2026 03:06
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