Skip to content

Add a generator for repo banners and profile tiles - #1

Merged
tpcarman merged 2 commits into
mainfrom
feature/repo-banners
Nov 14, 2026
Merged

tpcarman merged 2 commits into
mainfrom
feature/repo-banners

Conversation

@tpcarman

Copy link
Copy Markdown
Contributor

Summary

Adds generator/, a Node and Playwright script that renders the brand banner for every public AsBuiltReport.* repo from one HTML template, plus a workflow that keeps them up to date.

Output Size Path
README banner 1760 x 480 assets/repo-banners/<repo>.png
Profile tile 840 x 240 profile/images/tiles/<repo>.png
  • Line 3: PS> Install-Module <repo> when the module is on the PowerShell Gallery, the GitHub URL when it is not (currently AudioCodes.Mediant, Omnissa.Horizon, VMware.HorizonCloud, VMware.WorkspaceOneAccess, VMware.WorkspaceOneUEM and Veeam.VBAZ). The website shows www.asbuiltreport.com.
  • Fit check: long names shrink to fit, and the run fails rather than crop text.
  • Workflow: daily, on pushes to generator/ and by hand (optionally for named repos). It commits only images that changed. On this PR it renders without committing and uploads the images as the repo-banners build artifact, for review.
  • Tiles: the 20 existing profile tiles are regenerated from the same template, and tiles are added for the other modules.
  • Playwright is pinned to 1.64.1. Fonts and the logo mark are copied from the project website.

No images are committed in this PR. The workflow commits them on its first run after merge.

Test plan

  • Rendered all 33 repos locally: no overflow, the website banner matches repo-banner.png
  • Download the repo-banners artifact from this PR's run and check the Linux renders
  • After merge, confirm the bot commit adds assets/repo-banners/

🤖 Generated with Claude Code

Renders a README banner for every public AsBuiltReport.* repo into
assets/repo-banners/, and the module tiles on the organisation profile
into profile/images/tiles/, from one HTML template with Playwright.

Module banners show "PS> Install-Module <repo>" when the module is on
the PowerShell Gallery, and the GitHub URL when it is not. The website
banner shows www.asbuiltreport.com.

The Repo banners workflow runs daily, on pushes to generator/ and by
hand, and commits only the images that changed. On a pull request it
uploads the images for review without committing.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
readme-banners.mjs opens a pull request in each AsBuiltReport.* repo
that replaces the old organisation logo at the top of the README with
the repo's banner, or adds the banner at the top when there is no logo.
It is a dry run unless --apply is passed.

The repo list and API helpers move to repos.mjs, shared with render.mjs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@tpcarman
tpcarman merged commit 0dd718a into main Nov 14, 2026
1 check passed
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