This repository contains Tips, Tricks, and Resources to help you plan, organise, and execute your hackathons. Hopefully you'll find these useful when planning your next hackathon.
There are three main sections in this repository:
Guidelines are detailed below on how to contribute to each of these documents. If there are any issues within this repo you'd like to flag, please open an issue.
Please note this repository is NOT geared towards participants. This repository contains information and guides for hackathon organisers and managers. It does not contain tips, tricks, or resources for participating in a hackathon.
If you are looking for a hackathon to participate in, and you want some guidance you can check out the following sites:
- Major League Hacking
- DevPost
- Hackathons International
- Hackaday
- DevFolio
- Hack Club
- HackaList
- AngelHack
- Hackathon IO
- Game Jams
Tip for organisers: the above sites are great places where you can promote your hackathon!
The Tips and Tricks file contains lots of information on how to run your hackathon. Whether you're thinking about running an in-person, online hackathon, or hybrid hackathon, this document will help you answer some of your questions.
You can download this document as a PDF. Feel free to use it, share it around, and consult it.
If you have new ideas you'd like to add to the Tips and Tricks document, please head to the Discussions and start a conversation. If your tip or trick gets a lot of attention, we'll consider adding it to the documentation.
When talking about tips and tricks, ensure your additions/changes include information that is useful for hackathon organisers. If your addition or change does not include enough information or is not geared towards hackathon organisers, then your change will probably not be included. Remember, this repository is for hackathon organisers, not participants.
Organisers are often looking for good resources for running their hackathons. The Resources file contains a list of useful resources for you to consult. There's everything from platforms to host your hackathon, promotion sites, judging recommendations, communication tools, and more.
If you would like to add a resource to the Resources file, please open a pull request. Ensure your resource recommendation includes:
- Name of the resource
- Link to the resource (ie. website)
- Short description of the resource
See the Resources document to see how other resources are displayed. Please follow this format otherwise your pull request could be rejected. Ensure your resource is placed in the correct alphabetical order.
Format for adding your resource:
[Name of the Resource in H2 format](with link to website)
Short description, between two and four sentences long. Talk about what the resource is and how it can help organisers. Ensure the link above includes https instead of http.
# you can add an appropriate gif, short video, or image if it suits. However, this is not necessary.
Remember, this resource is for organisers, not participants. If your resource is not for organisers and does not meet the requirements above, your pull request may be rejected.
You can also head to the Discussions to talk about certain resources before adding them to the documentation.
This is a great place to connect to other hackathon organisers. You can use the Tips and Tricks or Resources Discussions before adding content to this repository. You can also share ideas, talk about random things, or ask questions.
This is an open community so feel free to answer any of the questions in the Discussions, comment on other people's threads, and share your own ideas. Remember, constructive thoughts and feedback is good, just please always be mindful not to shut people down or discourage other members of the community.
