https://github.com/owengretzinger/hackathon-inspiration

Get inspired by exploring real winning projects from Devpost hackathons
https://github.com/owengretzinger/hackathon-inspiration

drizzle-orm nextjs postgresql puppeteer shadcn tailwindcss trpc typescript

Last synced: 3 months ago
JSON representation

Get inspired by exploring real winning projects from Devpost hackathons

• Host: GitHub
• URL: https://github.com/owengretzinger/hackathon-inspiration
• Owner: owengretzinger
• Created: 2025-02-03T19:48:44.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-02-07T06:13:29.000Z (over 1 year ago)
• Last Synced: 2025-02-14T21:33:04.695Z (over 1 year ago)
• Topics: drizzle-orm, nextjs, postgresql, puppeteer, shadcn, tailwindcss, trpc, typescript
• Language: TypeScript
• Homepage: https://hackathon-inspiration.owengretzinger.com
• Size: 10.9 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          


  

    

  


Hackathon Inspiration

  


    Get inspired by exploring real winning projects from Devpost hackathons

  



  Table of Contents

  


    


      About The Project

      


        
Demo

      

    

    
Architecture

    


      Getting Started

      


        
Prerequisites

        
Installation

      

    

    
Contact

  


## About The Project

Hackathon Inspiration is a tool that allows you to get inspired for your next hackathon by exploring real winning projects from Devpost hackathons.

![Screenshot](/public/screenshot.png)

It was originally built as part of [HackMate](https://github.com/owengretzinger/hackmate) for the GDG Mac-a-Thon 2025, which won 1st overall.

Made possible by a web scraper I built that scrapes all information from winning projects for a given Devpost hackathon link. There are currently hundreds of winning projects across many hackathons in the database.

### Demo



  

    

  

  


    Click the image to see a short demo (HackMate demo video)

  



## Architecture

- **Frontend:**

  - Next.js (T3 Stack)

  - TypeScript

  - Shadcn UI

  - Tailwind CSS

  - Next-themes for dark/light mode support

  - React Query for data fetching

- **Backend**

  - tRPC (type-safe communication between frontend and backend)

  - Postgres Database (hosted on Neon)

  - Drizzle ORM with drizzle-kit for migrations

  - Vercel for deployment

- **Data Scraping:**

  - Puppeteer for web scraping

## Getting Started

### Prerequisites

- Node.js (v20 or higher)

- npm

### Installation

1. Clone the repo

   ```sh

   git clone https://github.com/owengretzinger/hackathon-inspiration.git

   ```

2. Install packages

   ```sh

   npm install

   ```

3. Configure environment variables

   ```sh

   cp .env.example .env

   ```

4. Start the development server

   ```sh

   npm run dev

   ```

## Contact

Owen Gretzinger - owengretzinger@gmail.com