Gitcord

Track smarter. Code better.

Gitcord is a comprehensive GitHub analytics platform that makes it effortless to monitor and analyze all your GitHub repositories. We provide deep insights with real-time stats, issue patterns, and contributor activity all from a single, unified dashboard.

• GitHub Activity Tracking - Monitor commits, pull requests, and contributions across all repositories
• Advanced Analytics - Get insights into coding patterns, language usage, and productivity trends
• Team Collaboration - Track team performance and manage organization-wide GitHub activity
• Real-time Dashboard - Unified dashboard with beautiful visualizations and leaderboards
• User Profiles - Customizable profiles with GitHub integration and contribution graphs
• Premium Features - Enhanced analytics and team collaboration tools
• Secure Authentication - NextAuth.js with GitHub OAuth integration

• Framework: Next.js 15 with App Router
• Language: TypeScript
• Styling: Tailwind CSS 4
• Database: MongoDB with Mongoose ODM
• Authentication: NextAuth.js with GitHub OAuth
• State Management: TanStack Query
• UI Components: Radix UI + Custom Components
• Charts: Recharts
• Animations: Framer Motion
• Package Manager: Bun

• Node.js 18+ or Bun
• MongoDB database
• GitHub OAuth App credentials

1. Clone the repository

   git clone https://github.com/lumi-work/gitcord.git
   cd gitcord

2. Install dependencies

   bun install

3. Set up environment variables

   cp .env.example .env.local

   Fill in your environment variables:

   MONGODB_URI="mongodb://localhost:27017/gitcord"
   NEXTAUTH_SECRET="your-secret-key"
   NEXTAUTH_URL="http://localhost:3000"
   GITHUB_ID="your-github-oauth-app-id"
   GITHUB_SECRET="your-github-oauth-app-secret"

4. Set up the database

   # Make sure MongoDB is running
   # The app will automatically create collections on first run

5. Run the development server

   bun run dev

6. Open your browser

   Navigate to http://localhost:3000 to see the application.

src/
├── app/                    # Next.js App Router pages
│   ├── api/               # API routes
│   ├── feed/              # Main dashboard pages
│   └── user/              # User profile pages
├── components/            # React components
│   ├── landing/          # Landing page components
│   ├── shared/           # Shared UI components
│   └── ui/               # Base UI components
├── hooks/                # Custom React hooks
├── lib/                  # Utility libraries
├── models/               # MongoDB models
└── types/                # TypeScript type definitions

• Authentication: /api/auth/[...nextauth]
• User Management: /api/user/*
• Messages: /api/message/*
• GitHub Data: Integrated via GitHub API
• Leaderboard: /api/leaderboard/*
• Premium Codes: /api/code/*

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

• Discord: Join our server
• Twitter: @works_lumi
• Email: [email protected]
• Status: Gitcord Status

This project is licensed under the MIT License.