A technical publication committed to the convergence of SEO and AI, through deep data analysis and practical implementation insights for the search optimization professional.
Headless WordPress + Astro hybrid architecture:
- Frontend: Astro static site with ISR (Incremental Static Regeneration)
- CMS: WordPress headless backend via REST API and GraphQL
- Deployment: Vercel with 24-hour cache invalidation
- Content: Unified system supporting both Astro MDX and WordPress posts
- Astro v4.15 - Static site generation with ISR
- TypeScript - Type-safe development
- Tailwind CSS v3.4 - Styling
- React v18.3 - Interactive components
- Fuse.js v7.0 - Unified search across all content
- WordPress - Headless CMS
- WPGraphQL - GraphQL API for WordPress
- MDX v2.2 - Advanced content authoring (legacy support)
- Sharp v0.33 - Image optimization
- Dynamic sitemaps (includes WordPress content)
- Structured data for both content types
- Automatic RSS feed generation
- Vercel - Deployment with ISR and analytics
- Node.js 18+
- WordPress installation (for CMS)
- Environment variables configured
# Install dependencies
npm install
# Configure environment (copy and edit)
cp .env.example .env.local
# Start development server
npm run dev
# Production build
npm run build
# Preview build
npm run preview
# Refresh WordPress content (production)
./refresh-posts.sh# WordPress Configuration
WORDPRESS_API_URL=https://your-cms-domain.com/wp-json/wp/v2
WORDPRESS_GRAPHQL_URL=https://your-cms-domain.com/graphql
# Optional: Site Configuration
SITE_URL=https://your-domain.com- Create and manage posts via WordPress admin
- Automatic synchronization with frontend
- SEO metadata via Yoast SEO
- Featured images and categories support
- Existing MDX posts in
src/content/blog/(deprecated) - Gradually migrating to WordPress
- Unified search includes both types
# Manual content refresh (triggers ISR)
./refresh-posts.sh
# Or via Vercel webhook (recommended)
POST /api/revalidateDetailed WordPress configuration guide available in README-WORDPRESS.md.
- WPGraphQL - GraphQL API
- Yoast SEO - SEO metadata
- WPGraphQL SEO Extension - SEO data via GraphQL
- Wordfence Security - Protection
- WPS Hide Login - Hide admin URLs
- ✅ Structured data (JSON-LD) for all content types
- ✅ Dynamic XML sitemaps with WordPress content
- ✅ RSS feeds with unified content
- ✅ Optimized images with Sharp
- ✅ ISR with 24-hour cache invalidation
- ✅ Unified search across all content
- ✅ Responsive design with mobile-first approach
- ✅ Fast page transitions
- ✅ Dark/light theme support
- ✅ Breadcrumb navigation
- ✅ TypeScript throughout
- ✅ Unified content types
- ✅ Automatic content synchronization
- ✅ Comprehensive error handling
Submit technical issues through GitHub Issues.
Content suggestions and collaborations via Contact Form.
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a pull request
Built with Dante, an Astro theme by JustGoodUI. Content licensed under CC BY 4.0, theme under GPL-3.0.
© 2025 Filippo Danesi