SecTracker 🛡️

SecTracker Banner

A Modern Bug Bounty and Security Research Management Platform

</div>

📋 Table of Contents

Overview
Features
Tech Stack
Getting Started
Configuration
Development
Contributing
License
Acknowledgments

🎯 Overview

SecTracker is your all-in-one platform for managing bug bounty hunting and security research activities. Track your findings, manage reports, and organize your security research workflow efficiently.

✨ Features

🎯 Platform & Program Management

Organize bug bounty platforms and programs
Track scope and bounty ranges
Manage platform-specific profiles

🐛 Bug Report Management

Detailed bug reporting with markdown support
Status tracking from draft to bounty awarded
Severity and impact assessment

📊 Dashboard

Visual overview of your hunting activities
Drag-and-drop customization
Progress tracking and statistics

📚 Research Tools

Integrated RSS feed reader
Reading list management
Personal notes and tips organization
Customizable security checklists

🛠️ Tech Stack

Frontend

React + TypeScript - Modern UI development
Vite - Blazing fast builds
Shadcn UI - Beautiful components
TanStack Query - Efficient state management

Backend & Database

Supabase - Backend services
PostgreSQL - Robust database
Real-time - Live updates

🚀 Getting Started

Prerequisites

Node.js (v18 or higher)
npm or bun package manager
PostgreSQL (if using local database)

Installation

Manual Installation

Clone the repository:

git clone https://github.com/secfathy/sectracker.git
cd sectracker

Install dependencies:

npm install
# or
bun install

Configure environment variables:

cp .env.example .env

Edit .env with your configuration:

# Supabase Configuration (Option 1)
VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key

# Direct PostgreSQL Configuration (Option 2)
DATABASE_URL=postgresql://user:password@localhost:5432/sectracker

Initialize the database:

# If using PostgreSQL directly
psql -U postgres -d sectracker -f database/init.sql

Start the development server:

npm run dev
# or
bun dev

🐳 Docker Setup

docker-compose up --build

🔧 Configuration Options

Supabase Setup

Create a new Supabase project
Copy your project URL and anon key
Update .env with Supabase credentials

Local PostgreSQL Setup

Create a new PostgreSQL database
Run the initialization script:

psql -U postgres -d sectracker -f database/init.sql

Update .env with database connection string

📖 Development

Project Structure

src/
├── components/     # React components
├── hooks/          # Custom React hooks
├── integrations/   # External service integrations
├── lib/            # Utility functions and configs
└── pages/          # Page components

Available Scripts

npm run dev - Start development server
npm run build - Build for production
npm run preview - Preview production build

🤝 Contributing

We welcome contributions! Please follow these steps:

Fork the repository
Create a feature branch
Commit your changes
Push to your branch
Open a Pull Request

📄 License

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

🙏 Acknowledgments

Shadcn UI for the beautiful components
Supabase for the backend infrastructure
Radix UI for accessible component primitives

<div align="center"> Made with 💙 for the Security Research Community by SecFathy </div>

Sectracker

Install / Use

README