> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firstcommit.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Your First Hackathon in 6 Steps

> A beginner-friendly roadmap for participating in Beginner's Paradise. Register, build, document, and submit your first hackathon project with confidence.

If you have never done a hackathon before, Beginner's Paradise is the perfect place to start. This roadmap breaks the whole experience into six simple steps so you can focus on learning and building without feeling overwhelmed.

<Steps>
  <Step title="Register on Devpost">
    Head to [firstcommit.devpost.com](https://firstcommit.devpost.com) and click **Register**. Create a Devpost account or log in, then confirm your entry. If you are working with teammates, each person must register individually.

    <Tip>
      Registration is free, and you can join solo or with a team of up to 6.
    </Tip>
  </Step>

  <Step title="Get an idea">
    Pick something that excites you. A personal dashboard, a small game, a mood tracker, a simple AI chatbot — anything counts. Start small. A project you can finish and explain beats an unfinished giant idea every time.

    <Tip>
      There is no required theme, so build what genuinely interests you.
    </Tip>
  </Step>

  <Step title="Set up your GitHub repo">
    Create a **public** GitHub repository for your project right at the start. This is required for submission, and having it ready early means you can commit your progress as you go. Add a basic README from day one.

    <Tip>
      Single-commit submissions are disqualified. Commit early and often to show your journey.
    </Tip>
  </Step>

  <Step title="Build and commit regularly">
    Work on your project throughout the hackathon period from August 21 to October 1. Make meaningful commits that show real progress. Do not worry if the code is messy or you hit bugs — that is part of the process.

    <Tip>
      You do not need to be an expert. Curiosity is the only requirement.
    </Tip>
  </Step>

  <Step title="Document your journey">
    Keep your README updated with an overview of your project, the tech you used, how to run it locally, credits for any resources you used, and an AI disclosure if you used AI tools. Write down what you learned, what challenges you faced, and how you overcame them.

    <Tip>
      Good documentation helps judges understand your work and shows off your growth.
    </Tip>
  </Step>

  <Step title="Submit on Devpost before October 1">
    Before the deadline, submit your project on Devpost. Include your public GitHub repo link, a demo video or presentation, and any screenshots or deployment links. If you are on a team, one person submits and adds teammates by email.

    <Tip>
      Do not wait until the last minute. Give yourself time to record your demo and double-check your links.
    </Tip>
  </Step>
</Steps>

## What to do next

Once you have submitted, take a moment to celebrate. You just completed your first hackathon. Explore other submissions, leave feedback for fellow participants, and join the [Discord](https://discord.firstcommit.xyz/) to share your experience.

## Related articles

* [How to Register](/getting-started/register)
* [Submission Requirements](/building/submission-requirements)
* [GitHub and Commit History](/building/github-guide)
