| title | Migrate an existing project to Astro | ||
|---|---|---|---|
| description | Some tips and tricks for converting your site to Astro. | ||
| sidebar |
|
||
| i18nReady | true |
import MigrationGuidesNav from '~/components/MigrationGuidesNav.astro';
Ready to convert your site to Astro? See one of our guides for migration tips.
Note that many of these pages are stubs: they're collections of resources waiting for your contribution!
Astro provides many benefits: performance, simplicity, and many of the features you want built right into the framework. When you do need to extend your site, Astro provides several official and 3rd-party community integrations.
Migrating may be less work than you think!
Depending on your existing project, you may be able to use your existing:
-
UI framework components directly in Astro.
-
CSS stylesheets or libraries including Tailwind.
-
Markdown/MDX files, with a configurable Markdown processor that supports plugins.
-
Content from a CMS through an integration or API.
Many existing sites can be built with Astro. Astro is ideally suited for your existing content-based sites like blogs, landing pages, marketing sites and portfolios. Astro integrates with several popular headless CMSes, and allows you to connect eCommerce shop carts.
Astro allows you have a fully statically-generated website, a dynamic app with routes rendered on demand, or a combination of both with complete control over your project rendering, making it a great replacement for SSGs or for sites that need to fetch some page data on the fly.
Depending on your existing project, you may need to think differently about:
-
Designing in Astro Islands to avoid sending unnecessary JavaScript to the browser.
-
Providing client-side interactivity with client-side
<script>tags or UI framework components. -
Managing shared state with Nano Stores or local storage instead of app-wide hooks or wrappers.