CoreDump

Push Limits, Break Barriers and Dominate

A comprehensive coding tracking platform that helps developers monitor their progress, maintain daily streaks, compete on leaderboards, and enhance their programming skills through gamification.

Live Demo • Documentation • VS Code Extension

Features

Core Features

• Daily Streak Tracking - Build consistent coding habits with streak monitoring
• Global Leaderboards - Compete with developers (24h & 7-day rankings)
• Multi-Language Support - Track programming languages with detailed analytics
• Real-time Progress - Live coding time tracking and productivity insights
• Developer Profiles - Comprehensive profiles with coding statistics and achievements
• Readme Card - Showcase your coding stats on GitHub with dynamic readme cards
• Time Display - Showcase your coding time in portfolio

Analytics & Insights

• Time Distribution - Visual breakdown of coding time across languages
• Language Badges - Beautiful badges showing your language proficiency
• Weekly/Daily - Detailed coding activity summaries

Public APIs

CoreDump provides public APIs to access coding statistics programmatically or display them in README files.

README Stats API

Generate SVG badges for your GitHub README:

GET /api/stats?username={username}&type={type}

Parameters:

• username (required): GitHub username
• type: stats-card (default) or total-time

Example:

![CoreDump Stats](https://coredump.vercel.app/api/stats?username=yourusername&type=stats-card)

Public Stats API

Access coding data in JSON format:

GET /api/public-stats?username={username}

Parameters:

• username (required): GitHub username

Response:

{
  "username": "yourusername",
  "weekTotal": "7h 30m",
  "todayTotal": "2h 15m"
}

Tech Stack

Frontend

• Framework: Next.js (App Router)
• Language: TypeScript
• Styling: TailwindCSS
• State Management: TanStack Query
• Authentication: NextAuth.js

Backend

• Database: PostgreSQL with Prisma ORM
• API: Next.js API Routes
• Authentication: JWT + NextAuth (Google)

Quick Start

Prerequisites

• Node.js 18+
• PostgreSQL database
• VS Code (recommended)

Installation

1. Clone the repository

   git clone https://github.com/unsafe0x0/CoreDump.git
   cd CoreDump

2. Install dependencies

   npm install
   # or
   yarn install
   # or
   bun install

3. Environment Setup

   cp .env.example .env.local

   Configure your environment variables:

   # Database
   DATABASE_URL="postgresql://username:password@localhost:5432/CoreDump"
   
   # NextAuth
   NEXTAUTH_SECRET="your-secret-key"
   NEXTAUTH_URL="http://localhost:3000"
   
   # OAuth (Google)
   GOOGLE_CLIENT_ID="your-google-client-id"
   GOOGLE_CLIENT_SECRET="your-google-client-secret"
   
   # Reset Key
   RESET_KEY="your-reset-key"

4. Database Setup

   npx prisma generate
   npx prisma db push
   npx prisma db seed

5. Start Development Server

   bun run dev

6. Install VS Code Extension

   • Download from GitHub
   • Or search "CoreDump" in VS Code marketplace here

Project Structure

coredump/
├── app/                    # Next.js App Router
│   ├── (auth)/            # Authentication routes
│   ├── api/               # API endpoints
│   │   ├── activity/      # Activity tracking
│   │   ├── auth/          # Authentication
│   │   ├── dashboard/     # Dashboard data
│   │   ├── leaderboard/   # Leaderboard data
│   │   ├── profile/       # Profile data
│   │   ├── public-stats/  # Public statistics API
│   │   ├── reset-duration/# Duration reset API
│   │   └── stats/         # README stats API
│   ├── dashboard/         # Dashboard page
│   ├── developer/         # Developer profiles
│   ├── docs/              # Documentation pages
│   ├── how-to-use/        # How-to-use guide
│   ├── leaderboard/       # Leaderboard page
│   └── page.tsx           # Home page
├── components/            # React components
│   ├── auth/              # Authentication components
│   ├── common/            # Shared UI components
│   ├── dashboard/         # Dashboard components
│   ├── docs/              # Documentation components
│   ├── how-to-use/        # How-to-use components
│   ├── landing/           # Landing page components
│   ├── leaderboard/       # Leaderboard components
│   └── profile/           # Profile components
├── context/               # React context providers
├── prisma/                # Database schema & migrations
├── public/                # Static assets
├── types/                 # TypeScript definitions
└── utils/                 # Utility functions

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

Made by UnsafeZero, for developers

Website • GitHub • Twitter • Discord