trackforge-saas

TrackForge - Open Source Traffic Tracker

TrackForge is a production-grade, open-source traffic tracking platform inspired by Keitaro. Built with modern technologies including Next.js 14, React 18, TypeScript, Supabase, and Drizzle ORM.

Features

• 🎯 Campaign Management - Create and manage traffic campaigns with advanced targeting
• 📊 Real-time Analytics - Monitor clicks, conversions, and ROI in real-time
• 🔄 Stream Distribution - Weighted traffic distribution across multiple offers
• 🌐 Traffic Sources - Manage multiple traffic sources with custom tokens
• 📈 Advanced Reports - Pivot tables, charts, and CSV exports
• 🔒 Authentication - Secure user authentication with Supabase
• 🎨 Modern UI - Beautiful, responsive interface with dark/light themes
• ⚡ High Performance - Built with Next.js 14 App Router and React Server Components

Tech Stack

• Frontend: Next.js 14, React 18, TypeScript, TailwindCSS
• UI Components: shadcn/ui, Radix UI
• Backend: Next.js API Routes, Server Actions
• Database: PostgreSQL with Supabase
• ORM: Drizzle ORM
• Authentication: Supabase Auth
• Rate Limiting: Upstash Redis
• Charts: Recharts
• Forms: React Hook Form + Zod validation

Getting Started

Prerequisites

• Node.js 18+ and pnpm
• PostgreSQL database (or Supabase account)
• Upstash Redis account (for rate limiting)

Installation

1. Clone the repository: ```bash git clone https://github.com/yourusername/trackforge.git cd trackforge ```

2. Install dependencies: ```bash pnpm install ```

3. Set up environment variables: ```bash cp .env.example .env.local ```

Fill in your environment variables:

• DATABASE_URL - Your PostgreSQL connection string
• NEXT_PUBLIC_SUPABASE_URL - Your Supabase project URL
• NEXT_PUBLIC_SUPABASE_ANON_KEY - Your Supabase anon key
• UPSTASH_REDIS_REST_URL - Your Upstash Redis URL
• UPSTASH_REDIS_REST_TOKEN - Your Upstash Redis token

1. Set up the database: ```bash pnpm db:generate pnpm db:migrate ```

2. Start the development server: ```bash pnpm dev ```

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

Project Structure

``` trackforge/ ├── app/ # Next.js 14 App Router │ ├── actions/ # Server Actions │ ├── api/ # API Routes │ ├── dashboard/ # Dashboard pages │ ├── campaigns/ # Campaign management │ └── layout.tsx # Root layout ├── components/ # React components │ ├── ui/ # shadcn/ui components │ ├── dashboard/ # Dashboard components │ └── campaigns/ # Campaign components ├── lib/ # Utilities and configurations │ ├── db/ # Database schema and connection │ ├── supabase/ # Supabase client configuration │ └── validations/ # Zod schemas ├── hooks/ # Custom React hooks └── scripts/ # Database scripts ```

Key Features

Campaign Management

• Create campaigns with multiple traffic streams
• Weight-based traffic distribution
• Advanced targeting rules (country, device, etc.)
• Real-time tracking URLs and postback URLs

Analytics Dashboard

• KPI cards showing clicks, profit, and ROI
• Interactive charts with time-range selection
• Real-time performance monitoring

Traffic Sources

• Manage multiple traffic sources
• Custom token configuration
• Dynamic tracking parameter support

Reports

• Pivot-style reporting with grouping
• Export data to CSV
• Visual charts and graphs

API Endpoints

Tracking

• GET /api/track?c={campaignId} - Track clicks and redirect to offers
• GET /api/postback?click_id={clickId}&status={status}&revenue={revenue} - Receive conversion postbacks

Database Schema

The application uses a PostgreSQL database with the following main tables:

• users - User accounts and authentication
• traffic_sources - Traffic source configurations
• campaigns - Campaign settings and metadata
• streams - Traffic distribution streams
• clicks - Click tracking data
• postbacks - Conversion tracking data

Contributing

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

Testing

Run the test suite: ```bash pnpm test ```

Deployment

The application is optimized for deployment on Vercel:

1. Connect your GitHub repository to Vercel
2. Set up environment variables in Vercel dashboard
3. Deploy automatically on every push to main branch

License

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

Support

For support and questions, please open an issue on GitHub or contact the maintainers.

---

Built with ❤️ by the TrackForge team