Skip to content

Remove the baked-in gradient from the target images (DES-274) - #493

Merged
cesartevisual merged 4 commits into
mainfrom
cesar-des-274-transparent-target-pngs
Aug 28, 2026
Merged

Remove the baked-in gradient from the target images (DES-274)#493
cesartevisual merged 4 commits into
mainfrom
cesar-des-274-transparent-target-pngs

Conversation

@cesartevisual

@cesartevisual cesartevisual commented Aug 28, 2026

Copy link
Copy Markdown
Collaborator

Description

Target images shipped with a gradient baked into the raster, so adding a new target meant recreating that gradient inside the image before uploading it. Every hero image is now a clean 800×600 transparent PNG — drop in a cutout and it matches. If we want the gradient back, it belongs in CSS on the hero component, applied once, instead of in every asset.

Also improved a couple of images along the way:

  • Jetson AGX Orin and Orin NX were still gradient-baked JPEGs, and their solutions heroes were wrong — AGX Orin pointed at a file that doesn't exist, Orin NX reused the Orin Nano photo. Both now use the new transparent art.
  • Removed the superseded .jpeg files and two unreferenced NVIDIA images.

While confirming the images resolved, fixed the remaining dangling references — these don't fail the build, they just render broken:

  • Three AGX Orin use-case images were never committed; repointed at existing art.
  • Four ogImage paths had drifted: iq9.jpegiq-9.jpeg, nxp-imx8mp.jpgnxp-imx8p.jpg, and both Raspberry Pi pages still referenced raspberry-pi.jpg, deleted back in 1f70b8b3.

Every /img/ reference across docs-hardware and the solutions data now resolves.

Review follow-ups

  • Grinn AstraSOM 1680 was missed by the first pass. It still had the baked-in glow, and its trim box was the 1033×1033 halo rather than the module. Regenerated as a clean 800×600 cutout.
  • Two canvases were left un-normalized, so those heroes rendered at a different scale under object-fit: contain: the HummingBoard RZ/V2N kept its 1080×1080 canvas after the glow came off, and the STM32MP257F-DK was a 1000×1000 cutout the first pass never touched. Both are 800×600 now — all 19 hero images are uniform.
  • The FRDM i.MX 93 pages rendered the wrong product. Both the hardware hero and the solutions hero pointed at NXP-FRDM-MCXN947.png, an MCX N947 MCU board, while the correct i.MX 93 art sat unreferenced. Repointed both; NXP-FRDM-MCXN947.png is kept, since it's correctly-named art for a real board rather than a superseded duplicate.
  • Five solution pages had a canonicalUrl pointing at a URL the site doesn't serve/solutions/raspberry-pi/raspberry-pi, /solutions/onlogic, /solutions/qualcomm/iq9, /solutions/seeed. None is a route and none has a redirect, so each was a canonical tag aimed at a 404. Copilot flagged two; the audit found three more. All 13 solution routes now match their own canonical, verified in the built HTML. Not fixed here: /solutions/stmicroelectronics/stm32mp157d-dk renders stm32mp257f-dk.ts, so the route names the wrong product — that needs a URL rename plus a redirect.
  • Copilot's use-case image flag: the image was right and its filename was wrong — factory-quality-inspection.png is a road scene under object detection, so it fits "Autonomous Vehicles". Renamed to road-scene-perception.png. The alt half was a real bug: UseCases rendered alt={useCase.title} and never declared imageAlt, so all 36 imageAlt values in the solutions data were dead. It now renders alt={useCase.imageAlt ?? useCase.title}.

Checklist

  • I have read the Contributing guidelines.
  • I have the right to submit this contribution, and I agree it is licensed to
    Peridio, Inc. as described in the Contributing guidelines.
  • This contribution contains no third-party personal data and nothing
    defamatory, infringing, or unlawful.
  • I ran the project checks (bash scripts/checks.sh) and they pass.

Target images shipped with a gradient baked into the raster, so adding a new
target meant recreating that gradient inside the image before uploading it. All
20 target images are now clean 800x600 transparent PNGs - drop in a cutout and
it matches. If we want the gradient back, it belongs in CSS on the hero
component, applied once, instead of in every asset.

Also improved a couple of images along the way:

- Jetson AGX Orin and Orin NX were still gradient-baked JPEGs, and their
  solutions heroes were wrong - AGX Orin pointed at a file that doesn't exist,
  Orin NX reused the Orin Nano photo. Both now use the new transparent art.
- Removed the superseded .jpeg files and two unreferenced NVIDIA images.

While confirming the images resolved, fixed the remaining dangling references -
these don't fail the build, they just render broken:

- Three AGX Orin use-case images were never committed; repointed at existing art.
- Four ogImage paths had drifted: iq9.jpeg -> iq-9.jpeg, nxp-imx8mp.jpg ->
  nxp-imx8p.jpg, and both Raspberry Pi pages still referenced raspberry-pi.jpg,
  deleted back in 1f70b8b.

Every /img/ reference across docs-hardware and the solutions data now resolves.
@cesartevisual
cesartevisual requested review from lee-reinhardt and nicksinas and a lite review from Copilot and removed request for Copilot August 28, 2026 17:08

Copilot AI 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.

Pull request overview

This PR updates the docs site’s solution metadata and hardware pages to stop relying on gradient-baked / outdated raster assets, and to ensure all referenced /img/... paths resolve to the current cleaned image set.

Changes:

  • Updated multiple ogImage paths in solution data to point at existing, correctly named assets.
  • Updated NVIDIA Jetson solution + hardware pages to use the new transparent .png hero images (instead of legacy .jpeg/incorrect files).
  • Repointed missing NVIDIA AGX Orin use-case image references to existing /img/use-cases/... assets.

Reviewed changes

Copilot reviewed 8 out of 32 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
src/src/data/solutions/raspberry-pi/raspberry-pi-5.ts Updates ogImage to the correct Raspberry Pi 5 asset.
src/src/data/solutions/raspberry-pi/raspberry-pi-4-model-b.ts Updates ogImage to a valid Raspberry Pi 4 image path.
src/src/data/solutions/qualcomm/iq9.ts Fixes ogImage filename drift (iq9.jpegiq-9.jpeg).
src/src/data/solutions/nxp/imx8mp.ts Fixes ogImage filename drift (nxp-imx8mp.jpgnxp-imx8p.jpg).
src/src/data/solutions/nvidia/jetson-orin-nx.ts Updates hero image path/alt text to the new Orin NX art.
src/src/data/solutions/nvidia/jetson-agx-orin.ts Updates OG/hero images and repoints missing use-case images to existing assets.
src/docs-hardware/nvidia/jetson-orin-nx/index.mdx Switches hardware hero image from .jpeg to .png.
src/docs-hardware/nvidia/jetson-agx-orin/index.mdx Switches hardware hero image from .jpeg to .png.
Suppressed comments (1)

src/src/data/solutions/nvidia/jetson-agx-orin.ts:86

  • This placeholder image (ml-inference-server.png) doesn’t match the “Surgical Robotics” use case, and UseCases uses the title as the <img> alt text. Consider switching to a closer-fit placeholder so the title-based alt isn’t misleading.
      image: '/img/use-cases/ml-inference-server.png',

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread src/src/data/solutions/nvidia/jetson-agx-orin.ts Outdated
Copilot flagged the Autonomous Vehicles use-case image as mismatched with its
title. The image was right and its filename was wrong: the file named
factory-quality-inspection.png is a road scene with cars, pedestrians, and
signage under object detection. Renamed it to road-scene-perception.png so the
name matches both the content and the use case. It had one referencer.

The other half of the comment was a real bug. UseCases renders alt={title} and
its props type never declared imageAlt, so all 36 imageAlt values in the
solutions data were silently dead. The component now renders
alt={imageAlt ?? title}, and the two AGX Orin cards Copilot pointed at describe
their art instead of restating the heading.
Copilot AI review requested due to automatic review settings August 28, 2026 17:18

Copilot AI 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.

Pull request overview

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

Comment thread src/static/img/Qualcomm-IQ9.png
Comment thread src/static/img/hardware/nxp/nxp_frdm-imx-93.png
lee-reinhardt
lee-reinhardt previously approved these changes Aug 28, 2026
The Grinn AstraSOM 1680 was missed by the first pass: it still carried the
baked-in blurple glow, and its trim box was the halo (1033x1033) rather than
the module. Regenerated as a clean 800x600 transparent cutout like the rest.

Two canvases were also left un-normalized, so the heroes rendered at
inconsistent scale under `object-fit: contain`: the HummingBoard RZ/V2N kept
its 1080x1080 canvas after the glow came off, and the STM32MP257F-DK was a
1000x1000 cutout the first pass never touched. Both are 800x600 now, which
makes all 19 hero images uniform.

The FRDM i.MX 93 pages rendered the wrong product: both the hardware hero and
the solutions hero pointed at NXP-FRDM-MCXN947.png, an MCX N947 MCU board
(silkscreen `FRDM-MCXN947`), while the correct i.MX 93 art sat unreferenced at
hardware/nxp/nxp_frdm-imx-93.png. Repointed both. NXP-FRDM-MCXN947.png is now
unreferenced but kept — it is correctly-named art for a real board, not a
superseded duplicate like the NVIDIA files this branch removed.

Copilot AI 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.

Pull request overview

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

Comment thread src/src/data/solutions/raspberry-pi/raspberry-pi-5.ts Outdated
Comment thread src/src/data/solutions/raspberry-pi/raspberry-pi-4-model-b.ts Outdated
Five solution pages emitted a `<link rel="canonical">` for a URL the site does
not serve, which tells search engines to drop the real page in favour of a 404:

  /solutions/raspberry-pi/raspberry-pi-5          -> .../raspberry-pi/raspberry-pi
  /solutions/raspberry-pi/raspberry-pi-4-model-b  -> .../raspberry-pi/raspberry-pi
  /solutions/onlogic/fr201                        -> .../onlogic
  /solutions/qualcomm/iq-9                        -> .../qualcomm/iq9
  /solutions/seeed/reterminal                     -> .../seeed

None of those five targets is a route under `src/pages/solutions`, and none has
a `plugin-client-redirects` entry, so each was a hard 404. Every canonical now
matches its own route; verified against the built HTML.

Note for a follow-up: `/solutions/stmicroelectronics/stm32mp157d-dk` renders
`stm32mp257f-dk.ts` — the route names a different product than the page
describes. Its canonical is self-consistent, so it is left alone here; fixing
it means renaming a public URL and adding a redirect.
Copilot AI review requested due to automatic review settings August 28, 2026 17:48

Copilot AI 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.

Pull request overview

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

@cesartevisual
cesartevisual merged commit afeb227 into main Aug 28, 2026
6 checks passed
@cesartevisual
cesartevisual deleted the cesar-des-274-transparent-target-pngs branch August 28, 2026 18:29
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.

3 participants