2023-03-06 15:06:33 -05:00
|
|
|
|
![Build the web you want](.github/assets/banner.png 'Build the web you want')
|
2023-01-21 06:06:55 -05:00
|
|
|
|
|
2022-05-03 19:06:04 -05:00
|
|
|
|
<p align="center">
|
2023-01-21 06:06:55 -05:00
|
|
|
|
<br/>
|
2022-05-03 19:06:04 -05:00
|
|
|
|
<a href="https://astro.build">Astro</a> is a website build tool for the modern web —
|
|
|
|
|
<br/>
|
|
|
|
|
powerful developer experience meets lightweight output.
|
|
|
|
|
<br/><br/>
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
## Install
|
|
|
|
|
|
2022-12-08 12:19:52 -05:00
|
|
|
|
The **recommended** way to install the latest version of Astro is by running the command below:
|
2022-05-03 19:06:04 -05:00
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
npm create astro@latest
|
2022-12-08 12:19:52 -05:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
You can also install Astro **manually** by running this command instead:
|
2022-05-03 19:06:04 -05:00
|
|
|
|
|
2022-12-08 12:19:52 -05:00
|
|
|
|
```bash
|
2022-05-03 19:06:04 -05:00
|
|
|
|
npm install --save-dev astro
|
|
|
|
|
```
|
|
|
|
|
|
2023-06-25 22:34:13 -05:00
|
|
|
|
Looking for help? Start with our [Getting Started](https://docs.astro.build/en/getting-started/) guide.
|
2022-05-03 19:06:04 -05:00
|
|
|
|
|
|
|
|
|
Looking for quick examples? [Open a starter project](https://astro.new/) right in your browser.
|
2023-06-25 22:34:13 -05:00
|
|
|
|
|
2022-05-03 19:06:04 -05:00
|
|
|
|
## Documentation
|
|
|
|
|
|
2022-08-15 12:29:33 -05:00
|
|
|
|
Visit our [official documentation](https://docs.astro.build/).
|
2022-05-03 19:06:04 -05:00
|
|
|
|
|
|
|
|
|
## Support
|
|
|
|
|
|
|
|
|
|
Having trouble? Get help in the official [Astro Discord](https://astro.build/chat).
|
2023-06-25 22:34:13 -05:00
|
|
|
|
|
2022-05-03 19:06:04 -05:00
|
|
|
|
## Contributing
|
|
|
|
|
|
2023-06-25 22:34:13 -05:00
|
|
|
|
**New contributors welcome!** Check out our [Contributors Guide](CONTRIBUTING.md) for help getting started.
|
2022-05-03 19:06:04 -05:00
|
|
|
|
|
|
|
|
|
Join us on [Discord](https://astro.build/chat) to meet other maintainers. We'll help you get your first contribution in no time!
|
|
|
|
|
|
|
|
|
|
## Directory
|
|
|
|
|
|
2023-10-25 15:37:34 -05:00
|
|
|
|
| Package | Release Notes |
|
|
|
|
|
| ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
|
|
|
| [astro](packages/astro) | [![astro version](https://img.shields.io/npm/v/astro.svg?label=%20)](packages/astro/CHANGELOG.md) |
|
|
|
|
|
| [create-astro](packages/create-astro) | [![create-astro version](https://img.shields.io/npm/v/create-astro.svg?label=%20)](packages/create-astro/CHANGELOG.md) |
|
|
|
|
|
| [@astrojs/react](packages/integrations/react) | [![astro version](https://img.shields.io/npm/v/@astrojs/react.svg?label=%20)](packages/integrations/react/CHANGELOG.md) |
|
|
|
|
|
| [@astrojs/preact](packages/integrations/preact) | [![astro version](https://img.shields.io/npm/v/@astrojs/preact.svg?label=%20)](packages/integrations/preact/CHANGELOG.md) |
|
|
|
|
|
| [@astrojs/solid-js](packages/integrations/solid) | [![astro version](https://img.shields.io/npm/v/@astrojs/solid-js.svg?label=%20)](packages/integrations/solid/CHANGELOG.md) |
|
|
|
|
|
| [@astrojs/svelte](packages/integrations/svelte) | [![astro version](https://img.shields.io/npm/v/@astrojs/svelte.svg?label=%20)](packages/integrations/svelte/CHANGELOG.md) |
|
|
|
|
|
| [@astrojs/vue](packages/integrations/vue) | [![astro version](https://img.shields.io/npm/v/@astrojs/vue.svg?label=%20)](packages/integrations/vue/CHANGELOG.md) |
|
|
|
|
|
| [@astrojs/lit](packages/integrations/lit) | [![astro version](https://img.shields.io/npm/v/@astrojs/lit.svg?label=%20)](packages/integrations/lit/CHANGELOG.md) |
|
|
|
|
|
| [@astrojs/node](packages/integrations/node) | [![astro version](https://img.shields.io/npm/v/@astrojs/node.svg?label=%20)](packages/integrations/node/CHANGELOG.md) |
|
|
|
|
|
| [@astrojs/vercel](packages/integrations/vercel) | [![astro version](https://img.shields.io/npm/v/@astrojs/vercel.svg?label=%20)](packages/integrations/vercel/CHANGELOG.md) |
|
2023-10-25 15:35:33 -05:00
|
|
|
|
| [@astrojs/cloudflare](https://github.com/withastro/adapters/blob/main/packages/cloudflare) | [![astro version](https://img.shields.io/npm/v/@astrojs/cloudflare.svg?label=%20)](https://github.com/withastro/adapters/blob/main/packages/cloudflare/CHANGELOG.md) |
|
2023-10-25 15:37:34 -05:00
|
|
|
|
| [@astrojs/partytown](packages/integrations/partytown) | [![astro version](https://img.shields.io/npm/v/@astrojs/partytown.svg?label=%20)](packages/integrations/partytown/CHANGELOG.md) |
|
|
|
|
|
| [@astrojs/sitemap](packages/integrations/sitemap) | [![astro version](https://img.shields.io/npm/v/@astrojs/sitemap.svg?label=%20)](packages/integrations/sitemap/CHANGELOG.md) |
|
|
|
|
|
| [@astrojs/tailwind](packages/integrations/tailwind) | [![astro version](https://img.shields.io/npm/v/@astrojs/tailwind.svg?label=%20)](packages/integrations/tailwind/CHANGELOG.md) |
|
|
|
|
|
| [@astrojs/alpinejs](packages/integrations/alpinejs) | [![astro version](https://img.shields.io/npm/v/@astrojs/alpinejs.svg?label=%20)](packages/integrations/alpinejs/CHANGELOG.md) |
|
|
|
|
|
| [@astrojs/mdx](packages/integrations/mdx) | [![astro version](https://img.shields.io/npm/v/@astrojs/mdx.svg?label=%20)](packages/integrations/mdx/CHANGELOG.md) |
|
|
|
|
|
| [@astrojs/prefetch](packages/integrations/prefetch) | [![astro version](https://img.shields.io/npm/v/@astrojs/prefetch.svg?label=%20)](packages/integrations/prefetch/CHANGELOG.md) |
|
2022-05-03 19:06:04 -05:00
|
|
|
|
|
2022-08-08 12:11:00 -05:00
|
|
|
|
[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/6178/badge)](https://bestpractices.coreinfrastructure.org/projects/6178)
|
|
|
|
|
|
2022-05-03 19:06:04 -05:00
|
|
|
|
Several official projects are maintained outside of this repo:
|
|
|
|
|
|
|
|
|
|
| Project | Repository |
|
|
|
|
|
| ------------------------------------------------------------------- | ----------------------------------------------------------------------- |
|
2023-06-25 22:34:13 -05:00
|
|
|
|
| [@astrojs/compiler](https://github.com/withastro/compiler) | [withastro/compiler](https://github.com/withastro/compiler) |
|
2022-05-03 19:06:04 -05:00
|
|
|
|
| [Astro Language Tools](https://github.com/withastro/language-tools) | [withastro/language-tools](https://github.com/withastro/language-tools) |
|
|
|
|
|
|
|
|
|
|
## Links
|
|
|
|
|
|
|
|
|
|
- [License (MIT)](LICENSE)
|
2022-07-12 10:16:08 -05:00
|
|
|
|
- [Code of Conduct](https://github.com/withastro/.github/blob/main/CODE_OF_CONDUCT.md)
|
|
|
|
|
- [Open Governance & Voting](https://github.com/withastro/.github/blob/main/GOVERNANCE.md)
|
|
|
|
|
- [Project Funding](https://github.com/withastro/.github/blob/main/FUNDING.md)
|
2022-05-03 19:06:04 -05:00
|
|
|
|
- [Website](https://astro.build/)
|
|
|
|
|
|
|
|
|
|
## Sponsors
|
|
|
|
|
|
2023-09-06 16:27:25 -05:00
|
|
|
|
Astro is free, open source software made possible by these wonderful sponsors.
|
2022-05-03 19:06:04 -05:00
|
|
|
|
|
2022-07-12 10:16:08 -05:00
|
|
|
|
[❤️ Sponsor Astro! ❤️](https://github.com/withastro/.github/blob/main/FUNDING.md)
|
2022-05-03 19:06:04 -05:00
|
|
|
|
|
2022-10-04 14:16:29 -05:00
|
|
|
|
<p align="center">
|
|
|
|
|
<a target="_blank" href="https://github.com/sponsors/withastro">
|
2023-01-21 06:06:55 -05:00
|
|
|
|
|
2023-06-25 22:34:13 -05:00
|
|
|
|
[![Astro's sponsors.](https://astro.build/sponsors.png "Astro's sponsors.
|
2023-09-06 16:27:25 -05:00
|
|
|
|
Platinum sponsors: Vercel, storyblok, Netlify, Ship Shape, Google Chrome
|
2023-08-15 12:18:02 -05:00
|
|
|
|
Gold sponsors: ‹div›RIOTS, DEEPGRAM, Transloadit, CloudCannon
|
2023-01-21 06:06:55 -05:00
|
|
|
|
Sponsors: Monogram, Qoddi, Dimension")](https://github.com/sponsors/withastro)
|
|
|
|
|
|
2022-10-04 14:16:29 -05:00
|
|
|
|
</a>
|
|
|
|
|
</p>
|