Repository navigation
Closed
Labels
area:ciBuild and CI pipelinesBuild and CI pipelinesarea:coremeta:needs-changelogstatus:needs-triageNew/ungroomed; needs review by PM/leadNew/ungroomed; needs review by PM/leadtype:task
Description
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
- Navigate to: https://app.netlify.com/sites/thisonetimeonacid/settings/general
- Locate "Build settings" section
- Set "Base directory" to:
src/app - Click "Save"
- Trigger new deployment via Netlify UI or push to branch
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-ControlCompletion 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.txtserves correctly (200 OK) - Verify
/sitemap.xmlserves correctly (200 OK) - Verify
/manifest.jsonserves 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
- Record actual response headers from production deployment
- Compare against expected headers (documented in PR perf: netlify - Add HTML revalidation and cache verification #343)
- Document any discrepancies
- Create before/after summary table
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
- Review PR perf: netlify - Improve hashed-asset caching and security headers #345 scope and relationship to PR perf: netlify - Add HTML revalidation and cache verification #343
- Determine if scope overlap needs to be documented or resolved
- Update issue perf: netlify - Improve asset caching and baseline headers #6 with resolution status
- Close or update any related subtasks
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
- PR perf: netlify - Add HTML revalidation and cache verification #343 code review approved and merged to
develop - Netlify base directory configured to
src/app - New deployment triggered and completed
- All header verification commands return expected values
- SPA routing works on production
- Integrations load without CSP violations
- Performance metrics documented and compared
- Documentation updated with deployment evidence
- PR perf: netlify - Improve hashed-asset caching and security headers #345 overlap resolved or documented
🔗 References
- PR perf: netlify - Add HTML revalidation and cache verification #343: Netlify Asset Caching & HTML Revalidation
- Issue perf: netlify - Improve asset caching and baseline headers #6: bug: netlify - Publish missing static metadata
- Verification Guide: docs/NETLIFY_CACHE_VERIFICATION.md
- Netlify Settings: https://app.netlify.com/sites/thisonetimeonacid/settings/general
Generated by Claude Code
Metadata
Metadata
Assignees
Labels
area:ciBuild and CI pipelinesBuild and CI pipelinesarea:coremeta:needs-changelogstatus:needs-triageNew/ungroomed; needs review by PM/leadNew/ungroomed; needs review by PM/leadtype:task
Type
Fields
Priority
None yet
Activity
linear-code commentedon Oct 22, 2026
TOA-359
docs & fix: Add integration validation plan and restore React build c…