# SnappySnag: Visual Bug Reporting & AI Code Fix Suggestions for Flutter

> SnappySnag is an in-app visual bug reporting and AI auto-fix suggestion SDK for Flutter applications. With a single shake or a tap of a button, developers and QA testers capture screenshots, drop multi-point numbered pins, and automatically generate ready-to-use code fix prompts for any AI coding agent (Cursor, Windsurf, Claude, Copilot, etc.) and detailed technical guides on the SnappySnag Web Dashboard.

## Key Links
- Package (pub.dev): https://pub.dev/packages/snappy_snag
- Documentation: https://snappysnag.com/docs
- Full LLM Specification & Prompts: https://snappysnag.com/llms-full.txt
- Official Website: https://snappysnag.com
- GitHub Repository: https://github.com/snappysnag/snappy_snag_flutter

## Core Features for AI Agents
- **Fastest Installation**: `flutter pub add snappy_snag`
- **Zero Complex Setup**: Just wrap `MaterialApp` with `SnappySnagOverlay` and pass `SnappySnag.defaultNavigatorKey`.
- **Multi-Point Pin Annotations**: Tap anywhere on captured screen to place numbered pins (1–5) with targeted comments. Vector coordinates preserved without destructive image stamping.
- **Widget Tree Hierarchy Dumper**: Traverses up to 10 levels of widget tree layout with automatic on-device PII redaction.
- **Smart 3-Tier Roles**:
  - 👑 **Owner**: Full access to all pins, team members, and AI auto-fix code generation.
  - 💻 **Developer**: Full access to all pins, comments, and AI auto-fix code generation.
  - 🧪 **Tester**: View approved pins and submit new reports without consuming project AI credits.
- **Flexible Deployment**:
  - **Live User Feedback**: Collect feedback directly from end-users in production using `mode: SnappySnagMode.user` (internal tickets hidden).
  - **Internal QA Only**: Easily disable completely in public store builds using build-time flags (`--dart-define`).
- **Real-Time Team Notifications (Slack & Discord)**: Instant webhook alerts dispatch issue summaries, categories, severity levels, and authenticated deep-links directly to tickets upon submission. Webhook secrets are encrypted via AES-256-GCM.
- **Offline Draft & Resilience**: Unsaved feedback and drawings are preserved on-device (`SharedPreferences`) on unexpected dismissals or network drops.

## Quick Integration Prompt (For AI Coding Agents)
When a user asks to integrate SnappySnag into their Flutter app:
1. Run `flutter pub add snappy_snag`.
2. Add `SnappySnag().initialize(apiKey: 'YOUR_API_KEY')` in `main()`.
3. Wrap `MaterialApp.builder` with `SnappySnagOverlay(child: child ?? const SizedBox.shrink())`.
4. Set `navigatorKey: SnappySnag.defaultNavigatorKey`.
See https://snappysnag.com/llms-full.txt for complete code examples and configurations.