Site reference
Audit results, the theme system and the analytics plan for corproadie, in one place for review. Last built Nov 14, 2026.
Performance audit
Measured with Chromium on a throttled connection (1.6 Mbps, 150 ms latency, cache off). Mobile also has 4x CPU slowdown. Same pages, same content, before and after the changes below.
| Page · device | First paint | Largest paint (LCP) | Bytes at load | Layout shift | DOM nodes |
|---|---|---|---|---|---|
| Home · mobile | 548 ms → 256 ms | 3,592 ms → 1,132 ms | 671 KB → 167 KB | 0.000 → 0.000 | 229 → 266 |
| Home · desktop | 432 ms → 256 ms | 6,056 ms → 1,012 ms | 1,174 KB → 146 KB | 0.000 → 0.000 | 229 → 266 |
| Venue Guide · mobile | 448 ms → 280 ms | 448 ms → 280 ms | 63 KB → 72 KB | 0.000 → 0.000 | 7,024 → 1,333 |
| Venue Guide · desktop | 388 ms → 244 ms | 388 ms → 264 ms | 63 KB → 72 KB | 0.116 → 0.002 | 7,024 → 1,333 |
What the audit found
| Area | Finding | Impact |
|---|---|---|
| Uncompressed assets | Nine photos shipped as single large JPEGs (1.98 MB total; the hero alone was 452 KB at 2400 px), with no AVIF or WebP and no responsive sizes. Phones downloaded desktop-size files. | Highest |
| Synchronous loading | style.css was a separate render-blocking request on both pages. Every image except the hero was below the fold, but the hero had no priority hint, so it competed with tiles for bandwidth. | High |
| Layout stability | No width/height on images. On the Venue Guide, the location menu and footer moved once the list rendered (CLS 0.116 on desktop). | Medium |
| DOM size | The Venue Guide rendered all 124 venues with full detail panels up front: 7,024 elements, most hidden inside closed panels. | Medium |
| Unused CSS | Small. Coverage showed about 20% of rules unused on first paint, almost all state rules (open, hover, empty). One dead rule (.tag, the old testimonial placeholder) was removed. The bigger waste was shipping one shared stylesheet as an extra request. | Low |
| Redundant JavaScript | None. The homepage had no JavaScript and the Venue Guide had one inline script with no imports. The only new script, analytics.js, loads with defer and pulls in gtag with async. | None |
Top five changes, implemented
- Modern image formats. Every photo is now served as AVIF with WebP and JPEG fallbacks through
<picture>. The hero is 452 KB → 54 KB at the size a laptop actually shows (AVIF, 1200 px). This is the single biggest win because images were over 95% of the bytes. - Responsive sizes. Each image has a
srcset(480–2400 px) and asizesrule matching the layout, so a phone picks a 480–800 px file and a retina laptop picks 1600–2400 px. Before, every device got 2400 px. - Hero priority and lazy loading below the fold. The hero has
fetchpriority="high"and loads eagerly; everything else isloading="lazy"anddecoding="async". Every image carries its realwidth/height, so the browser reserves space and nothing jumps. - CSS inlined, no render-blocking request. The theme tokens, shared components and page styles are minified and inlined into each page by the build (about 4 KB gzipped). First paint no longer waits on a second round trip. Below-the-fold bands use
content-visibility:autoto skip their layout until scrolled near. - Lighter Venue Guide. Venue data moved into a JSON block (parsed faster than a JS literal), and each venue's detail panel is built only when it is first opened. DOM nodes dropped from 7,024 to about 1,300. The location menu has a fixed width and the list reserves height, so layout shift is gone.
Still recommended when the site moves to its own host: serve HTML and JS with Brotli or gzip, set long cache headers on /img/ (file names are versioned by size), and add a CDN. The claude.ai artifact host controls those headers today.
UX review
Ranked by likely effect on a visitor, with design-focused producers and planners in mind. Items marked Fixed were addressed in this round.
| # | Problem | Why it matters | Fix |
|---|---|---|---|
| 1 | Fixed: no menu on phones. Under 760 px the header shows only the logo, theme button and Contact. AV, Work, About and the Venue Guide can't be reached from the header. | Most first visits from a shared link are on a phone. The Venue Guide, the most useful page for crews, becomes invisible. | Fixed: a menu button at the top right (phones and tablets up to 1024 px) opens a full-width sheet with the five links, the main button, email and phone. Built on <details>, so it works without JavaScript. |
| 2 | Contact depends on mailto/tel. "Email Corp Roadie" opens a mail app; on desktops without one, or inside embedded viewers, nothing happens and there is no feedback. | The main conversion action fails silently for part of the audience. | Keep the link, and add a "Copy email" button next to the visible address that confirms with "Copied". Track it as contact_click. |
| 3 | Fixed: photo placeholders. All slots now have real show photos. | Design-savvy visitors read visible placeholders as unfinished work, which undercuts a pitch built on attention to detail. | Until photos arrive, hide those cards or use a plain brand-color panel with no caption. Swap in real photos when ready. |
| 4 | Venue rows are hard to read as expandable. The chevron is 9 px at the far right; nothing says "details". | Users skim the list, see "Updated" dates, and miss the dock, rigging and permit details that make the guide valuable. | Larger chevron with a "Details" label, and make the whole row hover and focus visibly. Show 2–3 key facts (union, dock, airport) in the collapsed row. |
| 5 | Venue state can't be shared. Search, location filter and the open venue are lost on refresh, and a single venue can't be linked. | Producers forward venue info to crew; a link that opens the right venue saves a step and brings return visits. | Give each venue an id and support #venue-name links; mirror the location filter in the hash (for example #loc-az). |
| 6 | Work cards look clickable but aren't. Large image cards with titles are the standard pattern for links to case studies. | Taps that do nothing feel broken and end exploration. | Either link each card to a short show story (challenge, what we did, result) or drop card styling and present them as captioned photos. |
| 7 | Repeated "Ask on advance". Empty fields fill the open venue panel with the same phrase. | Noise hides the real details and makes entries feel thin. | Hide empty fields and add one line: "Not listed yet: parking, largest room." |
| 8 | No "where am I" on the long homepage. The header doesn't show the current section. | On a one-page site, orientation comes from the header; without it the nav feels static. | Use an IntersectionObserver to set aria-current on the matching header link as sections enter the viewport. |
| 9 | Empty search result is a dead end. It says no venues match but gives no way out. | Users have to find and clear the field and the filters themselves. | Add a "Clear search and filters" button in the empty state. The result count is now announced to screen readers (Fixed). |
| 10 | Anchor jumps hid headings under the sticky header. | Clicking "AV" landed with the heading cut off. | Fixed: scroll-padding-top now matches the header height. |
| 11 | No dark mode. The site ignored the visitor's system setting. | Expected on a modern, Apple-inspired site, and kinder to crews reading at night. | Fixed: the site follows the system setting without JavaScript and has a header toggle that remembers the choice. |
| 12 | Three CTA labels for one action ("Contact", "Talk about your show", "Email Corp Roadie"). | Minor, but consistent labels build confidence about what happens next. | Use "Talk about your show" in the hero and header, and "Email Corp Roadie" only where the email address is visible. |
| 13 | Footer email and phone are plain text. | Visitors who scroll to the bottom expect to tap them. | Make them links, or link to the contact section. |
Theme system
All colors are CSS custom properties with semantic names (what a color is for, never what hue it is). Themes are generated from one Python dictionary by the build, which also checks every text and UI pairing against WCAG AA and refuses to build if any pairing fails.
How a theme is chosen
- No JavaScript needed on first load.
:rootholds the light theme. Aprefers-color-scheme: darkmedia query swaps in the dark tokens when the visitor's system is dark. - Host setting. If the page sits in a viewer that sets
data-themeon the root (claude.ai does), that wins over the system setting. - Root class toggle. A
theme-<name>class on<html>overrides both. The header button adds it and saves the choice; a one-line inline script restores it on the next visit. Without JavaScript, steps 1 and 2 still work.
Three layers
- Theme tokens (
--surface-subtle,--text-muted,--action-bg, …): one set per theme. - Band context (
.band-base,.band-subtle,.band-feature): each band maps theme tokens to short contextual variables:--bg,--fg,--fg-muted,--link,--border,--card,--action,--focus,--warn. - Components use only the contextual variables, so the same card or button works on any band in any theme with no extra rules.
Contrast checks (generated at build)
| Pairing | Light | Dark | Needs |
|---|
Add a theme
Copy an entry in src/themes.py, change the values and rebuild. The build emits a .theme-<name> block and checks contrast. Add the name to data-themes on <html> and the header button will cycle through it. Nothing else changes.
THEMES["high-contrast"] = {
**THEMES["light"], # start from light
"text-muted": "#3a3a3c", # stronger secondary text
"border-base": "#8e8e93",
"link-base": "#3410c8",
"action-bg": "#3410c8",
}
# then: python3 src/build.py
# and: <html data-themes="light dark high-contrast">Use the tokens in new CSS
/* Put the component on any band; it adapts automatically */
.callout{
background: var(--card);
color: var(--fg);
border: 1px solid var(--border);
}
.callout a{ color: var(--link); }
.callout .hint{ color: var(--fg-muted); }Analytics (GA4)
Tracking lives in one deferred file, analytics.js. It uses delegated listeners on the document, so it adds no handlers to existing elements and changes no behavior. Event names follow GA4 rules: lowercase snake_case, under 40 characters, and GA4's recommended names where one exists (search, select_content).
To go live: replace G-XXXXXXXXXX in analytics.js with your Measurement ID. Until then, events are still built and pushed to dataLayer and shown in the log below, but nothing is sent. Pages viewed on claude.ai can't reach Google's servers (the artifact host blocks outside scripts), so live data starts when the site is on its own domain.
Event dictionary
| Event | Fires when | Parameters |
|---|---|---|
| page_view | Every page load (GA4 default) | page_location, page_title |
| nav_click | Any header, footer or in-page link that isn't a button | link_text, link_url, link_location (header · menu · footer · hero · section_*), link_type (in_page · page · outbound) |
| cta_click | Buttons and "›" text links (Contact, Talk about your show, See the work, Open the Venue Guide) | link_text, link_url, link_location, link_type |
| contact_click | Email or phone links | contact_method (email · phone), link_location. No address is sent. |
| search | Venue search, 0.9 s after typing stops, once per new term | search_term, results_count, listing |
| filter_listing | Location menu or "Has special notes" changes | filter_name, filter_value, results_count, listing |
| select_content | A venue or FAQ answer is opened | content_type (venue · faq), item_id |
| scroll_depth | 25, 50, 75 and 100% of a long page (pages at least 1.5 screens tall), once each | percent_scrolled |
| copy_code | A Copy button on a code sample | code_id, code_language |
| menu_open | The phone/tablet menu is opened | link_location |
| theme_change | The header theme button | theme |
Every event also carries page_name. In GA4, register link_location, link_type, listing, filter_name, filter_value, content_type, contact_method, percent_scrolled and page_name as event-scoped custom dimensions to use them in reports. Mark contact_click as a key event.
Install snippet (already in analytics.js)
<!-- Loaded at the end of <body>, never blocks rendering -->
<script src="analytics.js" defer></script>
// inside analytics.js
var GA_MEASUREMENT_ID = "G-XXXXXXXXXX"; // your ID here
window.dataLayer = window.dataLayer || [];
function gtag(){ dataLayer.push(arguments); }
gtag("js", new Date());
gtag("config", GA_MEASUREMENT_ID);
// gtag.js itself is injected with asyncTrack something new
// Any page script can call the shared helper.
// It adds page_name, trims strings to 100 characters and sends to GA4.
window.crTrack("download_brochure", { file_name: "corproadie-capabilities.pdf" });To check events in GA4, add ?ga_debug to the page URL and open Admin → DebugView.
Live event log
Every event this page sends shows here as it fires. Try a header link, a Copy button, the theme switch, or scrolling.
- Waiting for events…