[dfcoffin]

Summary

Prototype of the shared Green Button Alliance look for the Data Custodian and Third Party, based on a side-by-side review against greenbuttonalliance.org. Stacked on #242 (copyright notices); GitHub retargets it to main when #242 merges.

Shared theme: openespi-common/src/main/resources/META-INF/resources/css/gba-theme.css

Served by Spring Boot at /css/gba-theme.css in each app. Unlike the jar's application.properties, a static file cannot override an app's settings.

• Palette from the GBA site: dark green #2C4C3B (chrome, card headers), #3F6C54 (links), orange #F99742 (rules and accent borders only), blue #005B96 (section titles), slate #264653 (TP hero, DC admin portal), text #333 on #F8F8F8.
• Type and shape: Roboto 400/500/700, square corners, 2 px outlined buttons, white cards with a solid green header strip.
• Header: as on greenbuttonalliance.org, a dark-green top bar (slate for the DC custodian portal), a white band with the official GBA logo and green navigation links, and an orange rule. The logo and its ™ mark need the white background to stay legible.
• Footer: dark green with an orange rule, and links to greenbuttonalliance.org, the API docs and the source.
• Logo and favicon: META-INF/resources/images/gba-logo.png (120 px, 2× for 60 px display, 17 KB) and gba-favicon.png (64 px), resized from the logo on greenbuttonalliance.org. They are used with the GBA Technical Manager's authorization. Both apps now have a favicon.
• Bootstrap 5.3 variables and the DC's existing --gb-* tokens are remapped, so pages adopt the theme without markup changes.
• Contrast (WCAG): white on green 9.5:1, white on slate 10.1:1. Orange (2.2:1 on white) is never used for text.

Third Party

• New fragments/layout.html (head, header, footer). All 5 pages use it instead of repeating their own <head>/nav/footer.
• All links are context-relative (th:href), which fixes the navigation 404s in TP: home page navigation links ignore the /ThirdParty context path (404); dead energyos.github.io doc links #235 for these pages. The footer year is computed (2013-<current>), so it no longer goes stale.
• The navbar now links to Terms of Service and Usage Policy. Those pages and /error are permitted for anonymous users; previously they redirected to login.

Data Custodian

• The theme and Roboto load in the shared head. The GBA header is on the main and customer navbars, a slate variant on the custodian (admin) portal, and the GBA footer is used throughout.
• The home page cards use the GBA card style.
• Fixes the custodian dashboard hero: it was dark text on the new dark background (1.6:1); it is now white on slate (10.1:1).
• Duplicate Bootstrap JS removed from 4 pages; layout :: head already loads it, and double-loading breaks dropdowns.
• /css/** also serves the theme from the common jar, because @EnableWebMvc disables Boot's default static mappings.

Build fix: binary resources were never packaged (root pom.xml)

The root <resources> entry only included filtered text types (yml, properties, xml, sql, html, js, css), so every other resource was silently dropped from the jars:

• the 4 ESPI XSDs in openespi-common/schema/ (the certification validation target);
• the DC favicon, which always 404ed;
• the new logo.

A second, unfiltered <resource> now copies everything else as-is, and *.disabled files stay out. Verified: the PNGs and XSDs are in the common jar, the logo is byte-identical (no filtering corruption), and the AS/TP jars contain no .disabled files. Nothing loads the XSDs at runtime today, so packaging them changes no behaviour.

Both apps

Bootstrap CSS/JS and Bootstrap Icons are pinned with SRI integrity hashes, computed from the CDN files (they match Bootstrap's published 5.3.0 values).

Not in this prototype (follow-ups)

• The DC admin dashboard's action buttons still use Bootstrap's mixed colours (green/cyan/red/yellow) from the template itself; the other custodian pages need the same per-page pass.
• DC templates put the footer inside the page .container; the theme makes it full-width with CSS. Moving it out in the 20 templates is the cleaner fix.

Test plan

• mvn install -DskipTests for the full reactor; mvn verify DC: 172 tests pass; TP: 44 pass (2 skipped, pre-existing)
• Logo and favicon served (200) under /DataCustodian/images/ and /ThirdParty/images/; the old DC favicon now serves too
• Live on the local profile: theme served at /DataCustodian/css/gba-theme.css and /ThirdParty/css/gba-theme.css (200); TP /, /login, /TermsOfService, /UsagePolicy → 200 anonymously
• Screenshots checked: DC home, DC custodian dashboard (logged in), TP home at 1366 px and 390 px (no horizontal scroll at either width)

🤖 Generated with Claude Code