https://github.com/hackclub/hackathons

💥 Open source directory of free student-led high school hackathons.
https://github.com/hackclub/hackathons

hackathons hackclub high-school nextjs

Last synced: 3 months ago
JSON representation

💥 Open source directory of free student-led high school hackathons.

• Host: GitHub
• URL: https://github.com/hackclub/hackathons
• Owner: hackclub
• License: mit
• Created: 2019-12-23T08:03:52.000Z (about 5 years ago)
• Default Branch: main
• Last Pushed: 2024-11-01T05:02:57.000Z (3 months ago)
• Last Synced: 2024-11-01T06:16:54.361Z (3 months ago)
• Topics: hackathons, hackclub, high-school, nextjs
• Language: JavaScript
• Homepage: https://hackathons.hackclub.com
• Size: 7.68 MB
• Stars: 149
• Watchers: 15
• Forks: 31
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

• awesome-hackathon - Hack Club - A curated list of hackathons organized for high schoolers. (Tooling / Promoting)

README

        


Hack Club Hackathons

A curated list of hackathons organized by high schoolers for high schoolers.


### Introduction

Hackathons are awesome—but it’s hard to find a high quality directory of events for high schoolers. That’s where this project comes in.

**Goal:** create the best curated directory of hackathons for high school students. Because quite frankly hackathons shouldn't only be for university students.

### A word of warning…

To ensure that the directory remains as high quality as possible, we have strict guidelines for listing hackathons.

For the time being, primarily for ease of development, requests for listing new events happens through [this form](https://dash.hackathons.hackclub.com/hackathons/submissions/new).

Please do not open an issue or submit a pull request to add your event—the form is the easiest and fastest way for us to review submissions.

### Development environment setup

The stack: [Next.js](https://nextjs.org) & [Theme UI](https://theme-ui.com) with [Hack Club Theme](https://theme.hackclub.com).

Stuff you need installed ahead of time:

- Git

- Yarn

- An operating system (we hope)

Clone it!

    $ git clone https://github.com/hackclub/hackathons.git

Go into the directory!

    $ cd hackathons

Install dependencies!

    $ yarn

Run it!

    $ yarn dev

### Build and deploy

Deployment is managed using [Vercel](https://vercel.com). Install the Vercel CLI, and to force a production deploy, run:

    $ vercel --prod

### Hackathon Data

This front-end site is powered by the

[Hackathons Backend](https://github.com/hackclub/hackathons-backend).

The backend contains all the hackathon data and exposes it via a REST API

which is consumed by this app.

### License

This project is licensed under the MIT license. Please see [`LICENSE.md`](LICENSE.md) for the full text.