HC Wrapped 2026

A "Spotify Wrapped"-like site for Hack Club members to see their year in review!

It grabs data from Slack, Hackatime and the YSWS database to make a slideshow summary of your year in Hack Club.

Features

• Slack Integration
• Waitlist (to avoid the horrible rate limits Slack has)
• Data (wow!)
  • Total messages sent
  • Top channels
  • DM statistics
  • Confessions & meta messages
  • YSWS projects submitted
  • Hackatime stats
• Shareable Summary (lets you take a screenshot at the end)

Tech Stack

• Next.js
• TypeScript
• Tailwind
• Appwrite
• Slack API, Wakatime API
• Framer Motion

Getting Started

Prerequisites

• Node.js (v20 or later recommended)
• pnpm
• Slack App(s) (preferrably more than one to avoid rate limits) with appropriate permissions
• An Appwrite project

Installation

1. Clone the repository:

   git clone https://github.com/justdanielndev/wrapped-oss
   cd wrapped

2. Install dependencies:

   pnpm install

3. Environment Setup:

   Add this to a .env.local file:

   SLACK_CLIENT_ID=your_slack_client_id
   SLACK_CLIENT_SECRET=your_slack_client_secret
   
   APPWRITE_API_KEY=your_appwrite_api_key
   
   # Note: The Appwrite Endpoint, Project ID, Database ID, and Collection ID 
   # are currently hardcoded in src/lib/waitlist.ts together with redirect url since the app is not designed to be deployed by external individuals and made for Hack Club.

4. Run the dev server:

   pnpm dev

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