Hacktoberfest

Hacktoberfest is an annual event during the month of October to encourage open-source contributions. If you’ve ever wanted to contribute to Astro, this is your opportunity. From beginner to experienced, from developer to low/no-code contributor, you’re welcome!

Note

Participating Astro repositories, rules, instructions, and rewards may vary from year to year. Please consult this guide for up-to-date information every October!

Join the fest

To take part in Hacktoberfest, here’s all you need to do:

1. Register for the event on Hacktoberfest’s official website.
2. Make any valid contributions following Hacktoberfest’s rules during October.
3. Let us know you’re participating by requesting the PRs label hacktoberfest-accepted.

How to contribute to open-source

Especially for first-time contributors, open-source can be quite frightening — but don’t worry, we’re here to help you succeed!

In addition to our own resources for first-time contributors, here are a few reliable resources to help you prepare for your first Hacktoberfest contributions:

• What is open-source
• How to contribute to open-source
• How to use Git
• Getting started with GitHub Desktop

Allowed contributions

Astro welcomes contributions of all sizes from contributors of any experience level to this year’s participating repositories. To be considered for Hacktoberfest credit, the contribution must improve the quality of the repository with a helpful addition, improvement, or fix.

Small fixes such as correcting typos are welcome and appreciated! Larger contributions such as translating a page of documentation or submitting a fix to an existing issue may also count towards Hacktoberfest totals if the PR can be reviewed and merged during the month of October.

We will be closing PRs that do not meet our quality standards. Spam submissions will not be tolerated, and may result in being banned from the repo.

Caution

AI contributions will not be accepted. Hacktoberfest exists to motivate and reward human contributions to open-source projects, and therefore, we cannot accept contributions that have been made by automated tools.

AI assistance tools, such as GitHub Copilot or Cursor, may be used to help you draft your contribution but must be checked and edited for accuracy. If your submission contains obviously AI-generated errors, your PR will be rejected and you may be banned from further Hacktoberfest participation at our discretion.

Participating repositories

Astro Docs

withastro/docs contains the complete source code and content for the Astro documentation website in all the available languages.

Here are some of the main ways you can contribute to it:

• Reading the current or 5.0 beta docs and fixing any typos, grammar issues, or missing information.
• Helping translate the documentation in your language.
• Tackling open “good first issues” (or if you’re more familiar with Astro, “help wanted” issues) in the repository.

Astro Adapters

withastro/adapters is the repository for Astro’s official adapter integrations: Node.js, Netlify, Vercel, and Cloudflare.

Houston Discord Bot

withastro/houston-discord is Astro’s own Houston, a bot made to make the life of everyone within the Astro community easier.

Starlight

withastro/starlight is a full-featured documentation theme built on top of the Astro framework.

You can contribute to the Starlight theme by improving the documentation by fixing typos, grammar issues, missing information or by helping translate Starlight’s UI or documentation in your language.

Other repositories

Other Astro repositories may agree to add the hacktoberfest-accepted tag on a case-by-case basis.

Rewards

Astro allows you to earn Hacktoberfest achievements on your Astro Badge that “level up” as you contribute. Every contributor to Astro automatically has a profile card generated that tracks several achievements, like this one:

Enter your GitHub username and find your own contributor badge!