# ClientSummary

> Keep pushing code. We'll handle the client update.
> ClientSummary turns real GitHub commits into client-ready Progress Proof Cards and work updates in seconds.

## Product Overview
ClientSummary is an automated developer-to-client progress reporting platform. It bridges the communication gap between technical freelancers, software agencies, solo contractors, and their non-technical clients by ingesting GitHub commit history and transforming it into polished, human-friendly Progress Proof Cards with AI-synthesized summaries.

## Target Audience
- Software Freelancers and Solo Developers
- Independent Engineering Consultants
- Boutique Development Agencies & Studios
- Contractors reporting milestones to non-technical stakeholders

## Core Value Proposition
- **Zero Extra Effort**: Developers write commits and push code as usual. No manual timesheets or tedious status update drafting.
- **AI-Polished Summaries**: Powered by Google GenAI, technical jargon and git commits are translated into crisp, executive-ready accomplishment bullet points.
- **Multi-Repository Scoping**: Link one or multiple GitHub repositories to specific client projects.
- **Client-Ready Proof Cards**: Exportable, beautifully designed visual cards (PNG, PDF, web view) that reassure clients of consistent forward momentum.
- **Client Retention**: Eliminates the "what are we paying for?" anxiety, building verifiable trust and reducing client churn.

## Key Features
1. **GitHub OAuth Integration**: Secure, scoped access via GitHub OAuth. Fetches repositories, branches, and commit histories.
2. **Automated Progress Report Generator**: Generate updates for custom date ranges (e.g. "Past 7 days", "Since last report", or custom dates).
3. **Executive & Technical Snapshots**: Dual-layer reporting that gives non-technical clients clear highlights while providing engineers commit hashes and file diff counts.
4. **Export & Sharing**: One-click download as high-resolution PNG image, print/PDF export, or copyable Markdown and text summaries for email or Slack.
5. **Report History**: Living archive of past proof cards per client to track historical velocity.
6. **Mobile-First PWA Support**: Full Progressive Web App capability for iOS and Android, allowing on-the-go report generation and sharing.

## Security & Data Privacy
- **Least-Privilege GitHub Permissions**: ClientSummary only requests repository metadata and commit messages needed to generate summaries.
- **No Source Code Retention**: ClientSummary never clones or permanently stores private codebase files. Only commit log metadata and generated summaries are processed.
- **End-to-End Encryption**: GitHub OAuth tokens are encrypted with AES-256-GCM before storage.
- **Row-Level Security (RLS)**: Powered by Supabase RLS, ensuring each user's clients and reports are isolated and inaccessible to others.

## Pricing
- **Free Trial**: 7-day unrestricted trial with up to 3 clients.
- **Pro Tier**: Paid monthly subscription via Paystack for unlimited clients, multi-repo linking, and custom branding.

## Links & Endpoints
- Homepage: https://clientsync.vercel.app
- Documentation & LLM Full Reference: https://clientsync.vercel.app/llms-full.txt
- Sign In / Trial: https://clientsync.vercel.app/auth/login