Tailwind CSS v4 deployment guide: zero-ops edge publishing with Cloudflare Pages
Git-driven Tailwind CSS v4 deployment in practice: commit to build, atomic publish to every edge node.
On this page
Quick answer
Why are my Tailwind v4 custom brand colors not rendering?
Colors must be declared inside @theme (e.g. --color-brand). Forgetting @tailwindcss/vite, or still referencing the old config, makes bg-brand silently fail to render.
Machine-readable page data: /data/tailwindcss-deployment-guide.json
In-depth analysis
Tailwind CSS v4 replaces the bulky JavaScript config file with a CSS-first @theme directive, improving both build speed and control. At deploy time hand the built artifact to the edge platform and lean on static fallback plus security headers to hold the line on stability.
/* src/styles/global.css — Tailwind v4 CSS-first config, no tailwind.config.js needed */
@import 'tailwindcss';
@theme {
--color-brand: oklch(0.62 0.19 265);
--font-sans: 'Inter', system-ui, sans-serif;
}Tailwind CSS v4 Deployment Guide · Key takeaways
- astro.config has a single source-of-truth site value
- public/_headers declares nosniff and HSTS
- 404 returns a real 404
- Preview passes all 8 edge drills
FAQ & pitfalls
How do I long-cache Tailwind v4 build output at the edge?
The compiled CSS uses content-hashed filenames with immutable long cache. HTML references the new hash automatically, so no manual cache busting is required.
Explore the hub
See all 5 guides in Hands-onSame category as this article, sorted across the codebase.
Astro best practices: engineering conventions for production
Field-tested Astro practices from production, avoiding the common anti-patterns.
Astro deployment guide: zero-ops edge publishing with Cloudflare Pages
Git-driven Astro deployment in practice: commit to build, atomic publish to every edge node.
Astro performance tuning: push first paint and edge response to the limit
Around Astro's real bottlenecks, an actionable LCP / INP / CLS checklist.
Astro hands-on tutorial: from zero to your first runnable project
Step-by-step walkthrough of Astro with copy-paste commands, directory layout, and a first runnable artifact.
Share & save
What readers are asking
Questions that keep coming back in reader feedback, already answered.
- 01
Why is my custom Tailwind v4 brand colour not applied?
Colours must be declared in @theme (for example --color-brand). A missing @tailwindcss/vite plugin, or a leftover v3 config, makes bg-brand silently render nothing.
See the full guide → - 02
Why is my Astro component's interactivity not working?
Components ship as zero-JS HTML by default, so an interactive one needs a client:* directive (client:load, client:visible, …). Without it the script is never bundled into the page.
See the full guide → - 03
Why are _headers / _redirects not taking effect?
Both files must sit at the root of the output directory (dist/); anything under src/ is never uploaded. A purely static project should not add _worker.js either — that gives up the zero-cold-start advantage.
See the full guide →