Astro x Tailwind v4 projects on Cloudflare Workers. Use when working with Astro projects deployed to Cloudflare.
Astroflare
Expert guidance for TypeScript, Tailwind, and Astro framework for scalable web development on the Cloudflare platform.
Key Principles
- Write concise, technical responses with accurate Astro examples
- Prioritize static generation and server-side islands with minimal JavaScript
- Use descriptive variable names and follow Astro's naming conventions
- NEVER change the site output without explicit user confirmation - issues are likely elsewhere in configuration, environment variables, or build process
- Organize files using Astro's file-based routing system
- Native over frameworks: Prefer native HTML elements (
<dialog>,<form>) and web components over framework-specific solutions when possible. Use framework features only when they provide clear value.
Project Architecture
Deployment Target
- Cloudflare Workers with
output: 'static'and component server islands for server-side rendering - Use
server:deferdirective for server islands to optimize performance - Cloudflare adapter configured with platformProxy for forms/server actions
- Trailing slashes always (
trailingSlash: 'always') to match Cloudflare Workers behavior
Project Structure
src/
├── components/ # Astro components and custom web elements
│ ├── core/ # Reusable core components
│ ├── forms/ # Form components with client-side logic
│ ├── modals/ # Modal dialogs
│ └── animations/ # Animated components
├── layouts/ # Page layouts
├── pages/ # File-based routing
├── actions/ # Server actions (forms, API endpoints)
├── utils/ # Utility code
└── styles/ # Global styles
Component Development
- Create
.astrofiles for all components - this is the default and preferred approach - Use
components/core/for reusable components - Prefer custom web components over React islands for interactivity
- Use native HTML elements (
<dialog>,<form>) when possible
Package Management
- Use pnpm as the package manager
- Node version: 24.x
- pnpm version: >=10
References
For detailed guidance, see:
references/components.md- Component patterns and Starwind UIreferences/routing.md- Routing and pagesreferences/forms.md- Forms and server actionsreferences/styling.md- Tailwind CSS patternsreferences/seo.md- Comprehensive SEO guidereferences/testing.md- Testing patternsreferences/deployment.md- Build and deployment
You Might Also Like
Related Skills

cache-components
Expert guidance for Next.js Cache Components and Partial Prerendering (PPR). **PROACTIVE ACTIVATION**: Use this skill automatically when working in Next.js projects that have `cacheComponents: true` in their next.config.ts/next.config.js. When this config is detected, proactively apply Cache Components patterns and best practices to all React Server Component implementations. **DETECTION**: At the start of a session in a Next.js project, check for `cacheComponents: true` in next.config. If enabled, this skill's patterns should guide all component authoring, data fetching, and caching decisions. **USE CASES**: Implementing 'use cache' directive, configuring cache lifetimes with cacheLife(), tagging cached data with cacheTag(), invalidating caches with updateTag()/revalidateTag(), optimizing static vs dynamic content boundaries, debugging cache issues, and reviewing Cache Component implementations.
vercel
component-refactoring
Refactor high-complexity React components in Dify frontend. Use when `pnpm analyze-component --json` shows complexity > 50 or lineCount > 300, when the user asks for code splitting, hook extraction, or complexity reduction, or when `pnpm analyze-component` warns to refactor before testing; avoid for simple/well-structured components, third-party wrappers, or when the user explicitly wants testing without refactoring.
langgenius
web-artifacts-builder
Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.
anthropics
frontend-design
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.
anthropics
react-modernization
Upgrade React applications to latest versions, migrate from class components to hooks, and adopt concurrent features. Use when modernizing React codebases, migrating to React Hooks, or upgrading to latest React versions.
wshobson
tailwind-design-system
Build scalable design systems with Tailwind CSS v4, design tokens, component libraries, and responsive patterns. Use when creating component libraries, implementing design systems, or standardizing UI patterns.
wshobson