Hackathon Directory

A comprehensive directory of hackathons from around the world. Built with Next.js, TypeScript, and Tailwind CSS.

📋 Features

• Browse a curated list of hackathons
• Filter by upcoming and past events
• View hackathon details including date, location, prize, and more
• Responsive design for all devices

🚀 Getting Started

Prerequisites

• Node.js (v18 or newer)
• npm, yarn, or pnpm

Installation

1. Clone the repository:

   git clone https://github.com/imbjdd/hackathon-directory.git
   cd hackathon-directory

2. Install dependencies:

   npm install
   # or
   yarn install
   # or
   pnpm install

3. Run the development server:

   npm run dev
   # or
   yarn dev
   # or
   pnpm dev

4. Open http://localhost:3000 with your browser to see the result.

📝 How to Add a Hackathon

The hackathon data is stored in a YAML file located at data/hackathons.yml. To add a new hackathon:

1. Open the data/hackathons.yml file
2. Add a new entry following this format:

- id: [unique-identifier]
  name: [Hackathon Name]
  date: [Date or Date Range]
  location: [Location or "Online"]
  category: [Blockchain, AI, General, etc.]
  prize: [Prize amount or ""]
  website: [Official website URL]

Example:

- id: devfest2025
  name: DevFest 2025
  date: October 15-17, 2025
  location: San Francisco, USA
  category: General
  prize: 50k$
  website: https://example.com/devfest2025

Field Guidelines:

• id: A unique identifier for the hackathon (use lowercase, no spaces)
• name: The official name of the hackathon
• date: Use format "Month Day-Day, Year" or "Month Day, Year"
• location: City, Country or "Online"
• category: Main focus of the hackathon (e.g., Blockchain, AI, Web3, General)
• prize: Total prize pool (e.g., "50k$") or leave empty quotes "" if unknown
• website: Full URL to the official hackathon website

After adding your entry, save the file. The changes will be automatically reflected when the site is rebuilt.

🛠️ Technology Stack

• Next.js
• TypeScript
• Tailwind CSS
• js-yaml for YAML parsing

📄 License

This project is open source and available under the MIT License.

Contributors

Salim 💻

Jordan 💻

Pietro Carrucciu 💻