Introduction

Welcome to WP2Astro! This documentation will guide you through migrating your WordPress site to Astro, a modern static site generator that delivers exceptional performance and developer experience.

What is WP2Astro?

WP2Astro is a powerful migration tool that automatically converts your WordPress content, posts, pages, and media into a modern Astro website. It handles the complex transformation process so you can focus on what matters - delivering fast, beautiful websites to your users.

Why Migrate from WordPress to Astro?

Performance Benefits

• 10-100x faster load times - Pre-rendered static HTML means instant page loads
• Zero JavaScript by default - Ship only the JS you actually need
• Perfect Lighthouse scores - Achieve 100/100 performance scores
• Global CDN delivery - Deploy to edge networks worldwide for free

Cost Savings

• Free hosting on Netlify, Vercel, or Cloudflare Pages
• No plugin subscriptions - Built-in features replace paid plugins
• No database hosting - Content lives in Git
• Zero maintenance costs - No security patches or updates

Developer Experience

• Modern tooling - TypeScript, Vite, and hot module replacement
• Component-based - Build with React, Vue, Svelte, or pure HTML
• Type-safe - Catch errors before they reach production
• Git-based workflow - Version control for all content

Key Features

WP2Astro provides:

• ✅ Cloud-based IDE - Edit in your browser, powered by GitHub Codespaces
• ✅ No installation required - Start coding immediately
• ✅ WordPress import (optional) - Migrate existing sites or start fresh
• ✅ Live preview - See changes instantly as you type
• ✅ Auto-deployment - Push to Vercel automatically
• ✅ GitHub integration - Automatic repository creation and version control

Who is WP2Astro For?

WP2Astro is perfect for:

• Bloggers who want faster sites without WordPress maintenance
• Developers who want to build Astro sites without local setup
• Content creators who need a simple, cloud-based editor
• Anyone wanting to try Astro without installing anything
• WordPress users ready to migrate to a modern stack

What You'll Need

Before starting, you only need:

• A GitHub account (free)

That's it! No local development environment, no npm, no Node.js required. Everything runs in the cloud via GitHub Codespaces.

WordPress is optional: You can start with a blank Astro site or import existing WordPress content - your choice!

Ready to Get Started?

Continue to the Installation guide to begin your migration journey!

Need Help?

• Join our Discord community
• Email us at support@wp2astro.com
• Check the rest of the docs