Skip to content

fix(landing): stabilize logo and social assets#266

Merged
lentil32 merged 3 commits into
mainfrom
iconfix
Jun 1, 2026
Merged

fix(landing): stabilize logo and social assets#266
lentil32 merged 3 commits into
mainfrom
iconfix

Conversation

@lentil32
Copy link
Copy Markdown
Contributor

@lentil32 lentil32 commented Jun 1, 2026

One-Line Summary

Stabilize OneQuery logo, favicon, and social preview assets so docs and landing pages no longer depend on broken optimized PNG paths.

User-Facing Changes

  • Docs now use the SVG OneQuery logo through Starlight's native logo.src config.
  • Landing page header and diagram render the OneQuery logo as an inline Astro SVG component.
  • Social previews use a redesigned 1200x630 PNG at /og.png for broad crawler compatibility.
  • Browser/search favicon uses /favicon-96x96.png, while Apple touch uses /apple-touch-icon.png.
  • /onequery-icon.png remains as the stable 512x512 public brand logo for JSON-LD and crawler metadata.

Why This Changed

The deployed docs page previously referenced an optimized /_astro/onequery-icon.*.png path that was missing in the Cloudflare Workers build. The source PNG also existed in both src/assets and public, which made the intended ownership unclear. SVG is the better source format for the rendered app logo, while social cards and favicons need stable public PNG files for crawler and platform compatibility.

How It Changed

  • Added src/assets/onequery-icon.svg and pointed Starlight docs logo config to that SVG.
  • Switched landing logo render sites from PNG image imports to the SVG component import.
  • Replaced the previous large OG PNG with a redesigned compressed PNG social card.
  • Added dedicated public favicon assets:
    • /favicon-96x96.png for rel="icon" and Starlight favicon config.
    • /apple-touch-icon.png for Apple touch surfaces.
  • Removed duplicate source images that were no longer referenced:
    • src/assets/og.png
    • src/assets/onequery-icon.png

Bug Fixes

  • Under Cloudflare Workers deployment, docs could point to a missing optimized OneQuery icon PNG under /_astro/. This change moves the docs logo to a generated SVG asset path and keeps crawler-facing PNG URLs in public/.

Performance Notes

Raw file-size comparison:

Asset Before After Delta
public/og.png 428,772 B 121,548 B -307,224 B (-71.6%)
src/assets/og.png 428,772 B removed -428,772 B
src/assets/onequery-icon.png -> src/assets/onequery-icon.svg 35,588 B 1,722 B -33,866 B (-95.2%)
public/onequery-icon.png 35,588 B 35,588 B 0 B
public/favicon-96x96.png N/A 4,646 B +4,646 B
public/apple-touch-icon.png N/A 9,760 B +9,760 B

Extra Context / Decisions

  • The social preview image is PNG, not SVG, because PNG has better compatibility across Open Graph and Twitter/X preview crawlers.
  • The public 512x512 OneQuery icon stays in place for JSON-LD logo metadata and stable crawler URLs.

Verification

  • rtk bun run typecheck
  • rtk bun run build
  • rtk bun run format
  • rtk git push -u origin iconfix (pre-push lint-full passed with 0 warnings and 0 errors)

Video / Screenshot (Optional)

  • N/A

@cloudflare-workers-and-pages
Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
onequery-landing eedd9a1 Commit Preview URL

Branch Preview URL
Jun 01 2026, 02:37 AM

@lentil32 lentil32 enabled auto-merge (squash) June 1, 2026 02:38
@lentil32 lentil32 merged commit 7e5f2a9 into main Jun 1, 2026
9 checks passed
@lentil32 lentil32 deleted the iconfix branch June 1, 2026 02:39
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: eedd9a15c7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@@ -0,0 +1,7 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Update brand docs for the new logo source

This commit replaces src/assets/onequery-icon.png with this SVG, but repo-wide search still shows the brand guide directing readers to the deleted PNG (apps/landing/docs/brand-guide/logo.md:14 and :160, plus apps/landing/docs/brand-guide/color.md:19). Anyone following the landing brand docs after this change is pointed at a nonexistent source asset, so the docs should be updated to reference the new SVG/public PNG split.

Useful? React with 👍 / 👎.

logo: {
alt: "OneQuery",
src: "/src/assets/onequery-icon.png",
src: "/src/assets/onequery-icon.svg",
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Use a bundled path for the Starlight logo

This now points the docs logo at a root-relative /src/... URL, but the SVG was added under src/assets and there is no matching public file under public/src/assets (checked the public tree and repo-wide references). Starlight’s source-asset logo form expects a project-relative path such as ./src/assets/..., so the deployed docs can still render a missing logo request instead of bundling the SVG.

Useful? React with 👍 / 👎.

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