$ echo "submit your hackathon"

this project is open source. add your hackathon via pull request.

fork the repo

$ gh repo fork useing123/kazachi-kapai-hackathons

create your hackathon file

create a new file in data/hackathons/ with a URL-friendly name:

$ touch data/hackathons/my-hackathon.md

use this template:

---
name: "My Hackathon 2025"
date: "2025-10-15/2025-10-17"
url: "https://myhackathon.com"
description: "A short description"
location: "Online"
mode: "online"
tags: ["AI", "Web3", "Beginner-friendly"]
deadline: "2025-10-01"
organizer: "My Org"
status: "upcoming"
featured: false

# optional (for completed hackathons):
# winners:
#   - place: 1
#     project: "Cool Project"
#     team: "Team Name"
#     url: "https://project.dev"
# sponsors:
#   - name: "Sponsor Name"
#     url: "https://sponsor.com"
# totalParticipants: 200
# totalProjects: 40
---

your description goes here (markdown)

open a pull request

$ git checkout -b add/my-hackathon

$ git add data/hackathons/my-hackathon.md

$ git commit -m "add: My Hackathon 2025"

$ git push origin add/my-hackathon

then open a PR on github. we'll review and merge it.

$ schema reference

namerequired · string

daterequired · ISO range

urlrequired · string

descriptionrequired · string

locationrequired · string

moderequired · online | in-person | hybrid

tagsrequired · string[]

organizerrequired · string

statusrequired · upcoming | ongoing | completed

deadlineoptional · ISO date

featuredoptional · boolean

winnersoptional · array

sponsorsoptional · array