🚀 ProgressTracker

The ultimate developer progress tracking platform.

Monitor activity across 50+ coding platforms, set goals, build streaks, and share your journey.

---

✨ Features

• 🔄 Universal Sync: Automatically pull data from GitHub, LeetCode, HackerRank, Codeforces, and 45+ other platforms.
• 🔥 Heatmap Dashboard: A beautiful, GitHub-style 365-day activity heatmap to visualize your daily coding streaks.
• 🎯 Smart Goals: Set daily, weekly, or specific milestone goals and get automated email reminders when you fall behind.
• 🏆 Gamification: Earn 50+ unique achievements and badges for hitting personal milestones.
• 📊 Detailed Analytics: Dive deep into your platform breakdown, accuracy, time spent, and historical trends.
• 🔗 Shareable Profile: Generate a public profile link to share your coding resume with recruiters or friends.

🛠️ Tech Stack

Built with the modern web ecosystem for maximum performance and developer experience:

• Framework: Next.js 14 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS + shadcn/ui
• Database: PostgreSQL (hosted on Neon)
• ORM: Prisma
• Caching & Rate Limiting: Upstash Redis
• Auth: NextAuth.js v4 + custom TOTP Two-Factor Auth
• Emails: Brevo
• Payments: Stripe
• Background Jobs: Trigger.dev

🚀 Quick Start

1. Clone & Install

git clone https://github.com/PREM015/progresstracker.git
cd progresstracker
npm install

2. Configure Environment

cp .env.example .env.local

Fill in the highly required variables (DATABASE_URL, NEXTAUTH_SECRET, ENCRYPTION_KEY).

3. Database Setup

npm run prisma:generate
npm run prisma:migrate:dev

4. Run Development Server

npm run dev

Open http://localhost:3000 in your browser.

📚 Documentation

We have comprehensive documentation covering every aspect of the project.

👉 Start here: Documentation Home (docs/README.md)

Key Sections:

• 🏗️ Architecture Overview
• 🗄️ Database Schema
• 🔌 API Reference
• 🔐 Authentication Flow
• 🔄 Sync Architecture
• 💳 Billing & Stripe

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines to get started.

• Reporting Bugs? Use our Bug Report Template
• Requesting Features? Use our Feature Request Template

🛡️ Security

If you discover a security vulnerability, please review our Security Policy for reporting guidelines. Do not open public issues for security vulnerabilities.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

_{Built with ❤️ by PREM015 and the ProgressTracker Contributors.}