Astro is a website build tool for the modern web —
powerful developer experience meets lightweight output.
Install
The recommended way to install the latest version of Astro is by running the command below:
npm create astro@latest
You can also install Astro manually by running this command instead:
npm install astro
Looking for help? Start with our Getting Started guide.
Looking for quick examples? Open a starter project right in your browser.
Documentation
Visit our official documentation.
Support
Having trouble? Get help in the official Astro Discord or via GitHub discussions.
Contributing
New contributors welcome! Check out our Contributors Guide for help getting started.
Join us on Discord to meet other maintainers. We’ll help you get your first contribution in no time!
Directory
Several official projects are maintained outside of this repo:
| Project | Repository |
|---|---|
| @astrojs/compiler | withastro/compiler |
| Starlight | withastro/starlight |
Links
Sponsors
Astro is free, open source software made possible by these wonderful sponsors.
Summary
Content-driven web framework with islands architecture (62.9k stars, TS): ship zero JS by default, hydrate interactive islands only. The static-site-plus-sprinkles middle path between SSGs and full SPA frameworks. See Static Site Generators.
Learnings
- Islands vs hydration: the whole JS-framework argument collapses when the default is ‘no JS at all’ — interactivity becomes an explicit per-component opt-in. This is the architectural answer to why gatsby (OSS) lost.
Gotchas
- (none yet)
Hands-on
(open: hands-on if a future project needs embedded widgets without a runtime)