docs: repo-wide messaging update — README header redesign, centred layout, updated branding by Copilot · Pull Request #90 · bQuery/bQuery

Copilot · 2026-05-12T08:39:20Z

The README header was visually noisy and poorly ordered: title before logo, everything left-aligned, nine badges scattered one-per-line, the pitch buried below the badge wall, and a redundant repo self-link included. Additionally, branding strings were inconsistent across the codebase and docs metadata was stale.

Changes

Centre-aligned the full header block — converted to pure HTML (<h1>, <p>, <a><img/></a>) so CommonMark/GitHub renders correctly inside <div align="center">
Logo-first ordering — <img> at 80px above the <h1>, matching standard visual hierarchy
Pitch before metadata — tagline and description moved immediately after the title, before badges
Badge consolidation — two logical rows separated by <br/>:
- Row 1: npm version · bundle size · license
- Row 2: stars · open issues · CodeFactor · jsDelivr
Badge accessibility — descriptive alt text on all badge images (e.g. "npm version" instead of "npm")
Removed the circular "Repo" badge (reader is already on the repo) and the content-free "unpkg-browse" badge
--- separator between the header block and the release callout / Highlights body
VitePress metadata — docs/.vitepress/config.ts description updated to match the new tagline
Build banners — old slogan replaced in src/index.ts, vite.config.ts, and vite.umd.config.ts so generated bundles ship consistent branding
llms.txt runtime metadata — Runtime bullet expanded from Browser (ESM, UMD, IIFE) to include Node.js >=24.0.0 · Bun >=1.3.13 to reflect SSR/server runtime support

Agent-Logs-Url: https://github.com/bQuery/bQuery/sessions/36417cf4-1567-4e35-933e-1967051cb11e Co-authored-by: JosunLP <[email protected]>

Agent-Logs-Url: https://github.com/bQuery/bQuery/sessions/ec99796b-19f5-43d8-a7ab-27ecbcc25467 Co-authored-by: JosunLP <[email protected]>

Copilot

Pull request overview

This PR refreshes bQuery.js positioning and documentation presentation by redesigning the README header, updating taglines/descriptions across repo-facing docs, and introducing module maturity/status messaging for clearer expectations.

Changes:

Redesigns the README header layout (logo-first, centered block, consolidated badges) and updates highlights/messaging.
Updates product description/tagline across package.json, docs homepage/guides, and AI guidance files (AGENT.md, llms.txt, Copilot/Cursor/Cline rules).
Adds explicit module maturity/status information (Stable/Beta/Experimental) in key docs.

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
README.md	New centered, logo-first header; updated tagline/pitch; refreshed highlights; adds module status column and runtime note.
package.json	Updates npm package description to match new positioning.
llms.txt	Updates compact LLM summary + adds module maturity section.
docs/index.md	Updates docs homepage hero copy and “Why bQuery” narrative to match new positioning.
docs/guide/view.md	Refines security-related wording in view guide conclusion.
docs/guide/getting-started.md	Rewrites intro, adds stability/maturity note, and adds “where to start” pointers.
docs/guide/faq.md	Updates “What is bQuery.js?” framing and a use-case bullet to match new positioning.
docs/definition.md	Updates spec tagline/mission framing and adjusts a core principle entry.
AGENT.md	Updates identity block, adds “Positioning” and “Module Maturity” sections.
.github/copilot-instructions.md	Updates Copilot guidance wording to reflect “framework” positioning and expands module bullets.
.cursorrules	Updates short product description and adds “not a utility library” guidance.
.clinerules	Updates short product description and reinforces broader product scope wording.

Agent-Logs-Url: https://github.com/bQuery/bQuery/sessions/bf9758e7-7f83-4859-8268-37e39e564d03 Co-authored-by: JosunLP <[email protected]>

Copilot

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated 4 comments.

JosunLP · 2026-05-12T08:59:23Z

@copilot apply changes based on the comments in this thread

Agent-Logs-Url: https://github.com/bQuery/bQuery/sessions/7c1febf3-6fb7-472b-bcb8-c99b90cdbc44 Co-authored-by: JosunLP <[email protected]>

Copilot · 2026-05-12T09:01:25Z

@copilot apply changes based on the comments in this thread

Done in 4c830f8. Applied all four items from the review thread:

README.md — alt="npm" → alt="npm version" for better screen-reader clarity
src/index.ts, vite.config.ts, vite.umd.config.ts — build banner/JSDoc comment updated from the old slogan ("The jQuery for the Modern Web Platform") to the current tagline ("The full-stack web framework that speaks jQuery.")
llms.txt — Runtime bullet expanded from Browser (ESM, UMD, IIFE) to Browser (ESM, UMD, IIFE) · Node.js >=24.0.0 · Bun >=1.3.13

(The PR title/description update is a GitHub metadata change outside the code; that can be edited directly on the PR.)

Copilot

Pull request overview

Copilot reviewed 16 out of 16 changed files in this pull request and generated 4 comments.

Co-authored-by: Copilot Autofix powered by AI <[email protected]> Signed-off-by: Jonas Pfalzgraf <[email protected]>

Copilot

Pull request overview

Copilot reviewed 16 out of 16 changed files in this pull request and generated no new comments.

Copilot AI and others added 3 commits May 12, 2026 08:29

docs: refresh framework positioning across guidance and docs

d17805f

Agent-Logs-Url: https://github.com/bQuery/bQuery/sessions/36417cf4-1567-4e35-933e-1967051cb11e Co-authored-by: JosunLP <[email protected]>

docs: align remaining site pages with framework messaging

fd52fc3

Agent-Logs-Url: https://github.com/bQuery/bQuery/sessions/36417cf4-1567-4e35-933e-1967051cb11e Co-authored-by: JosunLP <[email protected]>

docs: redesign README header — centred, logo-first, grouped badges

bb4c9a6

Agent-Logs-Url: https://github.com/bQuery/bQuery/sessions/ec99796b-19f5-43d8-a7ab-27ecbcc25467 Co-authored-by: JosunLP <[email protected]>

Copilot AI assigned Copilot and JosunLP May 12, 2026

Copilot created this pull request from a session on behalf of JosunLP May 12, 2026 08:39 View session

JosunLP marked this pull request as ready for review May 12, 2026 08:39

Copilot AI review requested due to automatic review settings May 12, 2026 08:39

github-actions Bot added docs Changes to the documentation build Changes to the build and meta files github Changes to the github meta data files labels May 12, 2026

Copilot started reviewing on behalf of JosunLP May 12, 2026 08:40 View session

Copilot AI reviewed May 12, 2026

View reviewed changes

Comment thread README.md Outdated

Comment thread docs/index.md

Copilot started work on behalf of JosunLP May 12, 2026 08:46 View session

docs: convert README header to pure HTML; sync VitePress description

d73d384

Agent-Logs-Url: https://github.com/bQuery/bQuery/sessions/bf9758e7-7f83-4859-8268-37e39e564d03 Co-authored-by: JosunLP <[email protected]>

Copilot finished work on behalf of JosunLP May 12, 2026 08:50

Copilot AI requested a review from JosunLP May 12, 2026 08:50

JosunLP requested a review from Copilot May 12, 2026 08:53

Copilot started reviewing on behalf of JosunLP May 12, 2026 08:54 View session

Copilot AI reviewed May 12, 2026

View reviewed changes

Comment thread package.json

Comment thread package.json

Comment thread llms.txt

Comment thread README.md Outdated

Copilot started work on behalf of JosunLP May 12, 2026 08:59 View session

docs: fix badge alt text, sync branding strings, expand llms.txt runtime

4c830f8

Agent-Logs-Url: https://github.com/bQuery/bQuery/sessions/7c1febf3-6fb7-472b-bcb8-c99b90cdbc44 Co-authored-by: JosunLP <[email protected]>

Copilot AI changed the title ~~docs: redesign README header — centred, logo-first, grouped badges~~ docs: repo-wide messaging update — README header redesign, centred layout, updated branding May 12, 2026

Copilot finished work on behalf of JosunLP May 12, 2026 09:02

JosunLP requested a review from Copilot May 12, 2026 09:23

Copilot started reviewing on behalf of JosunLP May 12, 2026 09:23 View session

Copilot AI reviewed May 12, 2026

View reviewed changes

Comment thread AGENT.md Outdated

Comment thread llms.txt Outdated

Comment thread .cursorrules Outdated

Comment thread src/index.ts Outdated

Potential fix for pull request finding

51e6edb

Co-authored-by: Copilot Autofix powered by AI <[email protected]> Signed-off-by: Jonas Pfalzgraf <[email protected]>

Copilot AI review requested due to automatic review settings May 12, 2026 09:37

JosunLP and others added 2 commits May 12, 2026 11:37

Potential fix for pull request finding

b6ceb9b

Co-authored-by: Copilot Autofix powered by AI <[email protected]> Signed-off-by: Jonas Pfalzgraf <[email protected]>

Potential fix for pull request finding

de490e8

Co-authored-by: Copilot Autofix powered by AI <[email protected]> Signed-off-by: Jonas Pfalzgraf <[email protected]>

Copilot started reviewing on behalf of JosunLP May 12, 2026 09:38 View session

Potential fix for pull request finding

be1b504

Co-authored-by: Copilot Autofix powered by AI <[email protected]> Signed-off-by: Jonas Pfalzgraf <[email protected]>

Copilot AI reviewed May 12, 2026

View reviewed changes

JosunLP merged commit 990133f into dev May 12, 2026
7 checks passed

JosunLP deleted the copilot/update-bquery-rebranding branch May 12, 2026 09:45

Navigation Menu

Uh oh!

Uh oh!

docs: repo-wide messaging update — README header redesign, centred layout, updated branding - #90

docs: repo-wide messaging update — README header redesign, centred layout, updated branding#90
JosunLP merged 9 commits into
devfrom
copilot/update-bquery-rebranding

Copilot AI commented May 12, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

JosunLP commented May 12, 2026

Uh oh!

Copilot AI commented May 12, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Uh oh!

Conversation

Copilot AI commented May 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

JosunLP commented May 12, 2026

Uh oh!

Copilot AI commented May 12, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented May 12, 2026 •

edited

Loading