Skip to content

docs: add project logo to readme header#241

Merged
wadakatu merged 2 commits into
mainfrom
chore/add-logo-to-readme
May 14, 2026
Merged

docs: add project logo to readme header#241
wadakatu merged 2 commits into
mainfrom
chore/add-logo-to-readme

Conversation

@wadakatu
Copy link
Copy Markdown
Collaborator

Summary

Add images/logo.png and embed it centered above the existing H1 in README.md so the repo has a distinct visual identity at first glance.

Why

The README currently opens with badges only — no visual anchor. A logo above the H1 (Pest / Spatie / Tailwind-style) gives a faster brand recognition signal for visitors coming from social shares, listings, and search results, without sacrificing the descriptive H1 that screen readers and search indexers rely on.

Verification

  • Local rendering check: GitHub-flavored markdown <p align="center"> block resolves to a centered image on github.com.
  • The images/ directory is not in composer.jsonarchive.exclude, so the logo also ships inside the Packagist tarball — keeping the README functional anywhere the package is unpacked.

Notes for reviewers

  • The logo is rendered at width="480" while the source is 1774×887, so the asset stays crisp on retina displays.
  • The H1 (# OpenAPI Contract Testing for PHPUnit) is intentionally retained beneath the logo. Removing it would degrade screen-reader and SEO behavior with no visual benefit.

place a centered logo above the existing H1 so the repo has a distinct
visual identity at first glance. the H1 stays in place to preserve
both screen-reader accessibility and the existing SEO signal for the
descriptive title.
@wadakatu wadakatu enabled auto-merge (squash) May 14, 2026 08:45
the logo only renders meaningfully when the readme is viewed on
github; downstream consumers reading the unpacked readme from their
vendor/ directory don't benefit from the image, so trim it out of the
tarball to keep the shipped package focused on code.
@wadakatu wadakatu disabled auto-merge May 14, 2026 08:49
@wadakatu wadakatu merged commit 07c3bf1 into main May 14, 2026
16 checks passed
@wadakatu wadakatu deleted the chore/add-logo-to-readme branch May 14, 2026 08:49
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