Skip to content
hridhinvarkeyjosephPublic

About

Find open hackathons, get Go / Maybe / Skip verdicts, and turn your pick into a sprint plan. React, TypeScript, Android.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

hackmate.

Find the hackathon worth your weekend, then actually ship for it.

Try it live, no sign-up needed.

CI

Students miss hackathons because listings are scattered, deadlines slip, and nobody knows if a trip is worth it. Hackmate pulls open hackathons into one place, tells you Go, Maybe or Skip with a reason, and turns your pick into a day-by-day plan.

Near me ranks real hackathons with Go, Maybe and Skip

What makes it different

  • Go / Maybe / Skip on real listings. Each open hackathon from Unstop and Devfolio is judged on distance, how well it matches your themes, and clashes with your calendar. Every verdict shows its reasons.
  • Personal from the first minute. Pick your city and interests, and the rankings adapt straight away.
  • Sprint planner. One tap spreads a proven hackathon routine across the days you really have.
  • Today's focus. Your sprint plans become one short list of what to do now, with anything overdue first.
  • Pitch builder. Answer six simple questions and get a timed one-minute script you can practise and copy.
  • Submission readiness score. A live percentage and the three things that would raise it most.
  • Portfolio export. Turns what you shipped into a Markdown page for GitHub or a resume.
  • Team plans with no accounts. A share link carries the plan to teammates, while your notes, team names and submission links stay out of it.
  • Private by design. No account and no server. Your data stays on your device.
  • Works everywhere. Installable web app, offline support, and an Android app with system reminders.
Plan the sprint Find what fits On your phone
Sprint plan and readiness score Suggested hackathons Mobile layout

Also inside

Page links with Back support, offline and out-of-date notices, overview with countdowns, a searchable board, calendar with .ics export, insights, focus timer, deadline reminders, JSON backup and restore, dark mode, and keyboard shortcuts (N new, / search, Esc close).

How it works

flowchart LR
  A[Unstop and Devfolio] -->|daily GitHub Action| B[live-hackathons.json]
  B --> C[Validate and keep open listings]
  D[Your board and location] --> E[Ranking engine]
  C --> E
  E --> F[Go / Maybe / Skip]
  F -->|Track it| D
Loading

The logic lives in small, tested modules in src/lib:

Module Job
live.ts Validates feed data and selects open listings
finder.ts Locates venues, measures distance, ranks listings
planner.ts Builds the sprint plan
today.ts Chooses what to work on now
pitch.ts Writes and times the pitch script
readiness.ts Scores submission readiness
portfolio.ts Writes the Markdown portfolio
share.ts Creates and safely reads team share links
reminders.ts Schedules deadline reminders
platform.ts Handles file export on web and Android

Stack: React 19, TypeScript, Vite, Capacitor, hand-written CSS.

Quality: every push runs ESLint, type checks, Vitest unit tests, and Playwright browser tests that include automated accessibility checks. Data from feeds, backups and share links is validated before use.

Run it

npm install
npm run dev
Command What it does
npm test Runs the unit tests
npm run test:e2e Runs the browser tests
npm run lint Checks code quality
npm run build Type-checks and builds to dist/
npm run preview Serves the production build
npm run fetch:hackathons Refreshes the listings

Build the Android app with JDK 21 and the Android SDK:

npm run build
npx cap sync android
cd android && ./gradlew assembleDebug

Honest limits

  • Listings come from public, unofficial endpoints, so a source can change or go down. The app then keeps the last saved list.
  • Devfolio publishes no sign-up cutoff, so Hackmate shows its start date and says so.
  • Distances are straight-line estimates, and venues outside the known city list get a Maybe.

See the demo script for a two-minute walkthrough. Want to help? Read the contributing guide.

About

Find open hackathons, get Go / Maybe / Skip verdicts, and turn your pick into a sprint plan. React, TypeScript, Android.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages