Skip to content

Post-Merge: PR #343 Netlify Configuration & Deployment Verification #418

Closed

Description

@ashleyshaw

Overview

Follow-up verification tasks for PR #343 (Netlify Asset Caching & HTML Revalidation). This issue tracks infrastructure configuration and deployment verification that cannot be completed via code changes alone.

Related PR: #343
Related Issue: #6
Dependencies: Netlify base directory configuration (infrastructure access required)


🔴 BLOCKING: Netlify Base Directory Configuration

This must be completed first before any header verification is possible.

Configuration Steps

Verification

Once configured, run these verification commands:

# Should return: Cache-Control: public, max-age=31536000, immutable
curl -I https://thisonetimeonacid.netlify.app/assets/index-*.js | grep Cache-Control

# Should return: Cache-Control: public, max-age=31536000, immutable
curl -I https://thisonetimeonacid.netlify.app/assets/index-*.css | grep Cache-Control

# Should return: Cache-Control: public, max-age=0, must-revalidate
curl -I https://thisonetimeonacid.netlify.app/ | grep Cache-Control

# Should return: Cache-Control: public, max-age=0, must-revalidate
curl -I https://thisonetimeonacid.netlify.app/index.html | grep Cache-Control

Completion Criterion: All above commands return expected headers. Document actual headers in issue.


✅ Deployment & Routing Verification

HTML & SPA Routes

  • Navigate to production: https://thisonetimeonacid.netlify.app/
  • Verify page loads without errors
  • Verify SPA routes work:
    • /journal → returns 200 OK
    • /about → returns 200 OK
    • /contact → returns 200 OK
  • Browser console has no errors or CSP violations
  • Document any warnings or issues found

Static Metadata Files

  • Verify /robots.txt serves correctly (200 OK)
  • Verify /sitemap.xml serves correctly (200 OK)
  • Verify /manifest.json serves correctly (200 OK)
  • Verify cache headers are revalidation headers (max-age=0, must-revalidate)

Cache Verification

  • Open DevTools → Application tab
  • Navigate to /journal
  • Hard refresh (Cmd+Shift+R or Ctrl+Shift+R)
  • Verify new assets load (not served from stale cache)
  • Inspect Network tab for hashed asset filenames
  • Verify hashed files have 1-year cache headers
  • Simulate deployment update by hard refreshing
  • Verify updated styles/scripts load (not from cache)

🔗 Integration & CSP Validation

Google Fonts

  • Visit any page using Google Fonts (check all pages)
  • Fonts render without "font flash" or layout shift
  • Network tab shows font requests from fonts.gstatic.com (200 OK)
  • CSS file loads from fonts.googleapis.com (200 OK)
  • Browser console: no CSP violations for fonts

Typeform Embed

  • Navigate to /contact
  • Typeform contact form loads and displays
  • Form is interactive (can fill and submit if desired)
  • Browser console: no CSP violations for Typeform
  • Verify connection to Typeform servers succeeds

YouTube/Vimeo Embeds

  • Locate page(s) with YouTube embed (if any exist)
  • Video embed displays and is playable
  • Browser console: no CSP violations for video
  • Repeat for Vimeo embeds (if any)

CSP Full Assessment

  • Open DevTools → Console
  • Perform actions on each page type
  • Document any CSP violations found
  • If violations exist, assess whether policy needs updating (separate issue)

📊 Performance & Metrics

Before-After Header Comparison

Performance Measurement

  • Run Lighthouse audit on production
  • Record Core Web Vitals (LCP, FID, CLS)
  • Run PageSpeed Insights analysis
  • Document baseline metrics
  • Compare against previous deployment (if historical data available)
  • Document performance impact (positive/negative)

Cache Hit Rates

  • Monitor Netlify analytics for cache hit rates
  • Document % of requests served from cache
  • Compare before/after cache configuration

🔄 Related Issues & Cleanup

PR #345 Overlap Resolution

Documentation Updates

  • Update docs/NETLIFY_CACHE_VERIFICATION.md with actual deployment results
  • Add before-and-after header tables to documentation
  • Update CHANGELOG.md with verified deployment evidence
  • Document any issues found and their resolutions

📋 Acceptance Criteria


🔗 References


Generated by Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Fields

Priority

None yet

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions