Skip to content

feat(admin): brand the Payload admin with Clark's logo, colours and fonts - #55

Merged
maxitect merged 5 commits into
mainfrom
feat/44-clark-s-branding-for-the-payload-admin
Nov 13, 2026
Merged

maxitect merged 5 commits into
mainfrom
feat/44-clark-s-branding-for-the-payload-admin

Conversation

@maxitect

@maxitect maxitect commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

What

Clark's Bowling Club branding for /admin, using only Payload's CSS variables and documented component slots. No behaviour change.

Changes

  • Login logo and nav icon (bowling ball from public/svg/favicon.svg), through admin.components.graphics
  • custom.scss: site palette on Payload's variables, slate-950 dark theme, red for errors and the light focus ring, orange for the dark focus ring and the welcome panel, Blanch Caps on h1 and h2
  • Tab title suffix "- Clark's Bowling Club" and the site favicon through admin.meta
  • Dashboard welcome in English and French with links to tour dates, lyrics, the About carousel and the band guide (GitHub link to docs/admin-guide.md)

Acceptance criteria

AC Result Method Evidence
Login, nav and dashboard show logo and colours, light and dark, 1280 and 390 PASS browser AC1 below
Tab title ends with "- Clark's Bowling Club" and uses the site favicon PASS deploy AC2 below
Text and buttons pass WCAG AA in both themes PASS browser AC3 below
Create, edit, delete a tour date, a song and a carousel photo work as before PASS deploy AC4 below
Public site unchanged; stylesheet and font load only under /admin PASS deploy AC5 below
No new dependencies PASS code git diff main -- package.json pnpm-lock.yaml is empty

Closes

Closes #44

Notes

  • "Dark theme default" is read as: the dark theme's background is slate-950. The admin still follows the visitor's light or dark preference (admin.theme left at all), because the criteria ask for both themes.
  • Primary buttons keep Payload's own colours. Payload has no root variable for them; the only way to make them orange is to override .btn--style-primary, which the ticket rules out, and that override also hid the disabled state (an unmodified Save looked enabled). Focus rings are red in light and orange in dark: orange on white fails the 3:1 non-text contrast.
  • Payload's mid greys (--theme-elevation-350 to 550) carry hints and labels and failed AA (2.4:1 to 3.9:1). They are darkened in light and lightened in dark; borders that use them move with them.
  • Blanch Caps is on h1 and h2 only. On the small h3 card titles and group labels it was unreadable.
  • Calendar door upload on the deploy preview failed because Neon preview had no demos bucket. The bucket now exists there (private, with Neon's default CORS rule), and a door with an MP3 was created, read back and deleted through the admin UI.

Post-merge (production, not branding): Neon main has no demos bucket yet, so door uploads on production will fail until #50's post-merge steps 1 and 2 are done: create the private demos bucket on main, then allow PUT from https://clarksbowlingclub.com in its CORS rule.

  • The Framing 'https://app.netlify.com/' CSP console error on previews is Netlify's own deploy toolbar. The Route "/admin/[[...segments]]" ... runtime data in generateMetadata() dev warning comes from Payload's own metadata, not this change.
  • Test data: a throwaway user was created on the Neon preview database and removed. Test rows (tour date, song, media, carousel row, door) were deleted through the UI.

Review

Verdict: ALL CLEAR
Rounds: 2

Finding Severity Resolution
.btn--style-primary override (internal class name) made a disabled Save look enabled warning fixed in 0f92237
Deprecated priority prop on the login logo image (Next 16 uses preload) suggestion fixed in b62d250
Dashboard welcome links did a full page reload suggestion fixed in 713b2de

Re-verified: AC1 (browser: login, dashboard, door form, light and dark) PASS, AC3 (browser: contrast scan of 8 admin pages, both themes, 0 visible failures) PASS, AC4 (deploy: tour date, song, carousel photo and door CRUD on the rebased preview; tour date and song on the final tree locally) PASS, AC2 (deploy) PASS, AC5 (deploy: public CSS byte-identical to production, admin font only under /admin, no CSP violations) PASS · check.sh PASS

Evidence

AC1

Screenshots (scratchpad t44/): dash-light-1280.png, dash-dark-390.png, cal-dark-1280.png, p-login-light.png, p-dash-light.png, p-door-edit-dark.png, plus tour/calendar pages in both themes at 1280 and 390. The login page shows the ball and "Clark's Bowling Club" in Blanch Caps on slate-950; the dashboard shows the bilingual welcome panel with an orange edge. The colour picker (calendar door) renders as a swatch plus hex field in both themes.

AC2

https://deploy-preview-55--clarksbowlingclub.netlify.app/admin/login
title: "Login - Clark's Bowling Club"   dashboard: "Dashboard - Clark's Bowling Club"
<link rel="icon" href="/favicon.ico"/>   (site favicon; nav icon /svg/favicon.svg 200)

AC3

DOM scan of every text node (computed colour against nearest opaque background; 3:1 for large text, 4.5:1 otherwise) on the dashboard, tour date create, calendar settings, media create, About page and the tour date list, in light and dark, including the validation errors after an empty submit:

before: 21 failures in light (2.38 to 3.95), 5 in dark (1.18 to 4.19)
after:  every page, both themes: "bad":[]   (checked 43 to 114 text nodes per page)

Light error text #c14627 on white is about 5:1; dark error text #ee7a60 on #020618 is about 7:1.

AC4

All on the deploy preview, through the admin UI, read back with /api/*:

tour date: created .../tour-dates/12 | api create: 1 Brand44 Venue | api edit: 1 | api delete: 0
song:      create 1 | edit 1 | delete 0   (lyrics)
carousel:  media upload "Compressed in the browser: 1.47 MB to 660 KB." (ImageCompressor works)
           after add: 1 Brand44 carousel alt photo.jpg | after edit: Brand44 carousel alt edited
           carousel after remove: 0 | media after delete: 0
door:      edited via UI + colour picker: Brand44 door edited #a54425 | delete via UI: remaining 0

AC5

/, /about, /tour linked CSS: /_next/static/chunks/3cn78dhl8_v7c.css  admin markers (Blanch-Caps.2d6dli3, clarks-welcome, payload-default): 0
/admin/login linked CSS: one chunk (3btowec69hz_f.css) carries Blanch-Caps and clarks-welcome
Blanch-Caps woff2 on /admin: GET /_next/static/media/Blanch-Caps.2d6dli3-8_xdh.woff2 200, document.fonts.check = true
/admin CSP: font-src 'self' data: (no change to src/lib/security/headers.ts); no font or image CSP violation

@netlify

netlify Bot commented Nov 13, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for clarksbowlingclub ready!

Name Link
🔨 Latest commit 713b2de
🔍 Latest deploy log https://app.netlify.com/projects/clarksbowlingclub/deploys/6af667d5c28e3756b2f80d19
😎 Deploy Preview https://deploy-preview-55--clarksbowlingclub.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@maxitect
maxitect force-pushed the feat/44-clark-s-branding-for-the-payload-admin branch from c4a2b15 to 20ffeb2 Compare November 13, 2026 01:12
@maxitect
maxitect marked this pull request as ready for review November 13, 2026 01:28
@maxitect
maxitect merged commit 68cb38e into main Nov 13, 2026
5 checks passed
@maxitect
maxitect deleted the feat/44-clark-s-branding-for-the-payload-admin branch November 13, 2026 01:30
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.

Clark's branding for the Payload admin

1 participant