# mybets.gg - Comprehensive Documentation for LLMs

mybets.gg is a next-generation sports betting management platform designed to replace manual spreadsheets with AI-driven automation, deep performance analytics, and professional-grade betting tools.

## Project Vision
To provide bettors with a professional ecosystem that treats betting as an investment. This is achieved through data accuracy (AI automation), actionable insights (advanced analytics), and bankroll discipline.

## Core Feature Details

### 1. AI-Powered Data Entry
- **Screenshot Processing**: Uses Google Gemini Pro Vision to extract complex betslip data from images. 
- **Extracted Fields**: Sport, Event, Market, Selection, Stake, Odds, Date, and Bookmaker.
- **Browser Extension**: A Chrome extension that allows users to "snip" betslips directly from bookmaker sites (like Epicbet) and send them to the dashboard instantly.

### 2. Advanced Analytics Suite
- **Performance Overview**: Profit/Loss over time, ROI (Yield), and Win Rate.
- **Closing Line Value (CLV)**: Tracking edge against market movements.
- **Drawdown Analysis**: Visualizing peak-to-trough bankroll fluctuations to manage risk.
- **Segmented Stats**: Performance broken down by Bookmaker, Sport, Odds Range, and Strategy/Tag.
- **Bankroll Management**: Support for multiple bankrolls, deposits, withdrawals, and growth tracking.

### 3. Professional Betting Tools
- **Arbitrage Calculator**: Identify and calculate hedging opportunities.
- **EV (Expected Value) Calculator**: Determine the long-term value of a bet based on estimated probabilities.
- **Kelly Criterion**: Optimize stake sizes based on perceived edge and bankroll size.
- **No-Vig Calculator**: Remove bookmaker margin to find "fair" odds.
- **Odds Converter**: Seamlessly switch between Decimal, American, and Fractional odds.
- **Parlay Calculator**: Calculate potential returns for multi-bet selections.
- **Poisson Distribution**: Model expected outcomes for sports like football based on scoring averages.

### 4. Community & Syndicates
- **Syndicate Groups**: Create or join groups to share bets and track collective performance.
- **Social Sharing**: Generated graphics for sharing winning (or losing) bets with the community.

## Technical Implementation
- **Framework**: Next.js (App Router, React Server Components).
- **Styling**: Tailwind CSS with Shadcn UI and Tailark components.
- **Database**: Neon (Serverless Postgres) with Drizzle ORM.
- **Authentication**: Better Auth for secure user management.
- **Analytics**: PostHog for product usage and Vercel Analytics for performance.
- **Payments**: Integrated with Stripe/Creem for premium subscriptions.
- **Hosting**: Vercel.

## SEO and Accessibility
- **Light/Dark Mode**: First-class support for both, defaulting to user preference.
- **Performance**: Optimized for LCP (Largest Contentful Paint) and Core Web Vitals.
- **Metadata**: Comprehensive OpenGraph and Twitter metadata for all routes.
- **Sitemap**: Automatically generated sitemap.xml and robots.txt.

## Future Roadmap
- Strategy Tagging improvements.
- Real-time odds integration via APIs.
- CSV/JSON Export for external data processing.
- Advanced social features and leaderboards.