Skip to content

docs: use the dynamic README header endpoint - #6505

Merged
KevinVandy merged 1 commit into
betafrom
readme-header-endpoint
Aug 3, 2026
Merged

docs: use the dynamic README header endpoint#6505
KevinVandy merged 1 commit into
betafrom
readme-header-endpoint

Conversation

@AlemTuzlak

@AlemTuzlak AlemTuzlak commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

Adopts the dynamic README header endpoint added in TanStack/tanstack.com#1076,
which is merged and live.

Every README banner in this repo now points a <picture> at
https://tanstack.com/api/readme/ instead of a committed PNG. The endpoint
renders 1800x450 in light and dark, so a branding change lands in every README
at once and dark-mode readers get a dark banner.

What changed

  • 18 README(s) updated.
  • Light and dark served through <picture>, per GitHub's guidance. The trailing <img> stays the light variant, as the fallback for renderers that ignore <picture> (npm, most editors).
  • Per-package READMEs pass ?framework= so each banner shows its own package name instead of the generic library name.

There is no media/header_table.png on beta, so every one of these 18 READMEs was showing a broken image. This fixes that.

Verification

Every generated URL in this diff was requested against the live endpoint and
returned 200 image/png at 1800x450. git grep confirms no README still
references the old media/header_*.png path.

Heads up: deleting the committed PNG means npm pages for already-published
versions that embed the raw.githubusercontent.com/.../main/media/header_*.png
link will show a broken image, since that link is branch-pinned. New releases
pick up the endpoint URL.

Summary by CodeRabbit

  • Documentation
    • Updated project and package README headers with responsive images that adapt to light and dark themes.
    • Added accessible image descriptions and consistent display sizing.
    • Updated framework-specific branding and fallback images across package documentation.

@coderabbitai

coderabbitai Bot commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

README header images across the repository now use responsive <picture> elements with dark- and light-theme sources, accessible fallback text, and fixed widths.

Changes

README header updates

Layer / File(s) Summary
Responsive theme-aware headers
README.md, packages/*/README.md
Static local header images were replaced with responsive <picture> elements. The headers select dark- or light-theme TanStack-hosted images and define accessible fallback images with fixed widths.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Suggested reviewers: kevinvandy

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the migration of README headers to the dynamic endpoint.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch readme-header-endpoint

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@packages/match-sorter-utils/README.md`:
- Around line 5-13: Update the README header image block to use an available
package-specific match-sorter-utils header URL, including the established
framework query parameter when supported; otherwise retain the generic image
URLs but change the img alt text from “TanStack Table” to accurately describe
`@tanstack/match-sorter-utils`.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 32d971e5-25a0-4f55-a9ba-8f1daafdd17e

📥 Commits

Reviewing files that changed from the base of the PR and between 00bccc4 and 135664a.

📒 Files selected for processing (18)
  • README.md
  • packages/alpine-table/README.md
  • packages/angular-table/README.md
  • packages/ember-table/README.md
  • packages/lit-table/README.md
  • packages/match-sorter-utils/README.md
  • packages/octane-table/README.md
  • packages/preact-table-devtools/README.md
  • packages/preact-table/README.md
  • packages/react-table-devtools/README.md
  • packages/react-table/README.md
  • packages/solid-table-devtools/README.md
  • packages/solid-table/README.md
  • packages/svelte-table/README.md
  • packages/table-core/README.md
  • packages/table-devtools/README.md
  • packages/vue-table-devtools/README.md
  • packages/vue-table/README.md

Comment on lines +5 to +13
srcset="https://tanstack.com/api/readme/table.png?theme=dark"
/>
<source
media="(prefers-color-scheme: light)"
srcset="https://tanstack.com/api/readme/table.png"
/>
<img
src="https://tanstack.com/api/readme/table.png"
alt="TanStack Table"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

printf 'Repository files matching README names:\n'
git ls-files | grep -E '(^|/)README\.md$' | sed -n '1,80p'

printf '\nTarget README contents lines 1-30:\n'
if [ -f packages/match-sorter-utils/README.md ]; then
  cat -n packages/match-sorter-utils/README.md | sed -n '1,40p'
else
  echo 'packages/match-sorter-utils/README.md not found'
fi

printf '\nPattern for package README headers in repo:\n'
rg -n 'framework=match-sorter-utils|framework=table|srcset="https://tanstack\.com/api/readme/table\.png|alt="TanStack' packages -g 'README.md' | sed -n '1,200p'

Repository: TanStack/table

Length of output: 7654


🌐 Web query:

TanStack documentation static readme images framework table.png

💡 Result:

The TanStack Table repository uses various images in its documentation, including header images often located in a /media directory within the source code [1][2]. Specific images like table.png have appeared in the repository's README or media assets, such as header_table.png [1], though these file names may change or be updated alongside the library's evolution. Because TanStack Table is a headless library, it does not mandate a specific UI, so images in the documentation generally serve to demonstrate the library's branding or common usage patterns rather than required UI components [3][4][5]. If you are looking for specific assets, they are typically found in the repository under the media/ folder [1], or hosted as public assets for use in the documentation at tanstack.com [1]. Note that older versions (e.g., React Table v6) used different branding, such as logo-react-table.png [6][7].

Citations:


Use an available package-specific header for @tanstack/match-sorter-utils.

The README currently uses the generic Table header URLs and alt="TanStack Table", which makes this package README inconsistent with other TanStack Table packages that include framework= in their header URLs. Use a supported match-sorter-utils header URL if one is provided; otherwise keep the generic header but change the alt text so the image describes its package.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/match-sorter-utils/README.md` around lines 5 - 13, Update the README
header image block to use an available package-specific match-sorter-utils
header URL, including the established framework query parameter when supported;
otherwise retain the generic image URLs but change the img alt text from
“TanStack Table” to accurately describe `@tanstack/match-sorter-utils`.

@KevinVandy
KevinVandy merged commit 594aa78 into beta Aug 3, 2026
5 checks passed
@KevinVandy
KevinVandy deleted the readme-header-endpoint branch August 3, 2026 11:41
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