v1.0.0

🎉 Universal Crash Analytics API v1.0.0

Production-ready crash reporting service that works with any application!

✨ What's New in v1.0.0

🔒 Enterprise Security

• HMAC Authentication - Cryptographically signed requests prevent spoofing
• Rate Limiting - IP-based protection (60 req/min default)
• Data Validation - 15+ validation rules prevent malicious payloads
• Row Level Security - Database-level insert-only policies
• Anonymous Reporting - Zero personal data, SHA-256 hashed IPs only

🛠️ Core Features

• Universal API - One endpoint for all your apps (Python, JS, Go, etc.)
• Auto-Setup - Tables created automatically on first use
• Database-first - Tries API first, falls back to local storage
• Multi-app Support - Single deployment handles multiple applications
• Hardware Analytics - Comprehensive system information collection

📊 Analytics & Insights

• 100+ SQL Queries - Ready-to-use analytics for crash data
• Hardware Breakdowns - GPU, CPU, memory analysis
• Error Pattern Detection - Find common crash causes
• Version Comparison - Track stability across releases
• Dashboard Ready - Works with Grafana, Metabase, custom apps

🚀 Deployment

• Free Hosting - Uses Cloudflare Workers + Supabase free tiers
• 5-Step Setup - Fork → Configure → Deploy → Done
• Self-Healing - Recreates missing tables automatically
• Production Ready - Battle-tested with comprehensive validation

🎯 Perfect For

• Indie Developers - Cost-effective crash reporting
• Startups - Scalable alternative to expensive services
• Open Source Projects - Community-friendly crash analytics
• Enterprise Teams - Self-hosted with full data control

📚 Quick Start

# 1. Fork and clone
git clone https://github.com/YOUR-USERNAME/crash-analytics-api.git
cd crash-analytics-api

# 2. Install dependencies  
pnpm install

# 3. Configure Cloudflare Worker
# Set environment variables in Cloudflare dashboard

# 4. Deploy
pnpm run deploy

# 5. Test
API_ENDPOINT="your-endpoint" HMAC_SECRET="your-secret" pnpm test

💡 Usage Example

from crash_reporter import install_crash_handler

# One line to add crash reporting to any Python app
reporter = install_crash_handler(
    app_name="my-app",
    app_version="v1.0.0", 
    api_endpoint="https://your-worker.workers.dev",
    hmac_secret="your-secret"
)

# All crashes now automatically reported + stored locally if API down

📊 Analytics Examples

-- GPU crashes in last 7 days
SELECT hardware_specs->'gpu'->>'name' as gpu, COUNT(*) as crashes
FROM crash_reports 
WHERE created_at > NOW() - INTERVAL '7 days'
GROUP BY gpu ORDER BY crashes DESC;

-- App stability comparison
SELECT app_version, COUNT(*) / COUNT(DISTINCT ip_hash) as crashes_per_user
FROM crash_reports GROUP BY app_version;

🔗 Links

• Repository: https://github.com/reshdesu/crash-analytics-api
• Documentation: See README.md for complete setup guide
• Analytics Queries: database/example-queries.sql (100+ examples)
• Issues: Report bugs or request features

---

Built with ❤️ for the developer community. Free, open source, and privacy-first.