[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DPZBTP7ZMNEF48SJ22NTAS":3,"skill-same:01M7DPZBTP7ZMNEF48SJ22NTAS":77},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":30,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":33,"install":34,"resources":46},"01M7DPZBTP7ZMNEF48SJ22NTAS","sentry-flutter-sdk",null,"Full Sentry SDK setup for Flutter and Dart. Use when asked to \"add Sentry to Flutter\", \"install sentry_flutter\", \"setup Sentry in Dart\", or configure error monitoring, tracing, profiling, session replay, or logging for Flutter applications. Supports Android, iOS, macOS, Linux, Windows, and Web.","Hazek-dc\u002FPresensiGuru_FaceNet_EMAR","Hazek-dc","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F75208960?v=4","01M7DEQV5B4YGS86A81DYH81DR","Hazek","01M7DEQV5XP4TM0C6NTHXCXCHR",1,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsentry-flutter-sdk\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: sentry-flutter-sdk\ndescription: Full Sentry SDK setup for Flutter and Dart. Use when asked to \"add Sentry to Flutter\", \"install sentry_flutter\", \"setup Sentry in Dart\", or configure error monitoring, tracing, profiling, session replay, or logging for Flutter applications. Supports Android, iOS, macOS, Linux, Windows, and Web.\nlicense: Apache-2.0\ncategory: sdk-setup\nparent: sentry-sdk-setup\ndisable-model-invocation: true\n---\n\n> [All Skills](..\u002F..\u002FSKILL_TREE.md) > [SDK Setup](..\u002Fsentry-sdk-setup\u002FSKILL.md) > Flutter SDK\n\n# Sentry Flutter SDK\n\nOpinionated wizard that scans your Flutter or Dart project and guides you through complete Sentry setup — error monitoring, tracing, session replay, logging, profiling, and ecosystem integrations.\n\n## Invoke This Skill When\n\n- User asks to \"add Sentry to Flutter\" or \"set up Sentry\" in a Flutter or Dart app\n- User wants error monitoring, tracing, profiling, session replay, or logging in Flutter\n- User mentions `sentry_flutter`, `sentry_dart`, mobile error tracking, or Sentry for Flutter\n- User wants to monitor native crashes, ANRs, or app hangs on iOS\u002FAndroid\n\n> **Note:** SDK versions and APIs below reflect `sentry_flutter` ≥9.14.0 (current stable, February 2026).\n> Always verify against [docs.sentry.io\u002Fplatforms\u002Fflutter\u002F](https:\u002F\u002Fdocs.sentry.io\u002Fplatforms\u002Fflutter\u002F) before implementing.\n\n---\n\n## Phase 1: Detect\n\nRun these commands to understand the project before making any recommendations:\n\n```bash\n# Detect Flutter project type and existing Sentry\ncat pubspec.yaml | grep -E '(sentry|flutter|dart)'\n\n# Check SDK version\ncat pubspec.yaml | grep -A2 'environment:'\n\n# Check for existing Sentry initialization\ngrep -r \"SentryFlutter.init\\|Sentry.init\" lib\u002F 2>\u002Fdev\u002Fnull | head -5\n\n# Detect navigation library\ngrep -E '(go_router|auto_route|get:|beamer|routemaster)' pubspec.yaml\n\n# Detect HTTP client\ngrep -E '(dio:|http:|chopper:)' pubspec.yaml\n\n# Detect database packages\ngrep -E '(sqflite|drift|hive|isar|floor)' pubspec.yaml\n\n# Detect state management (for integration patterns)\ngrep -E '(flutter_bloc|riverpod|provider:|get:)' pubspec.yaml\n\n# Detect GraphQL\ngrep -E '(graphql|ferry|gql)' pubspec.yaml\n\n# Detect Firebase\ngrep -E '(firebase_core|supabase)' pubspec.yaml\n\n# Detect backend for cross-link\nls ..\u002Fbackend\u002F ..\u002Fserver\u002F ..\u002Fapi\u002F 2>\u002Fdev\u002Fnull\nfind .. -maxdepth 3 \\( -name \"go.mod\" -o -name \"requirements.txt\" -o -name \"Gemfile\" -o -name \"*.csproj\" \\) 2>\u002Fdev\u002Fnull | grep -v flutter | head -10\n\n# Detect platform targets\nls android\u002F ios\u002F macos\u002F linux\u002F windows\u002F web\u002F 2>\u002Fdev\u002Fnull\n```\n\n**What to determine:**\n\n| Question | Impact |\n|----------|--------|\n| `sentry_flutter` already in `pubspec.yaml`? | Skip install, jump to feature config |\n| Dart SDK `>=3.5`? | Required for `sentry_flutter` ≥9.0.0 |\n| `go_router` or `auto_route` present? | Use `SentryNavigatorObserver` — specific patterns apply |\n| `dio` present? | Recommend `sentry_dio` integration |\n| `sqflite`, `drift`, `hive`, `isar` present? | Recommend matching `sentry_*` DB package |\n| Has `android\u002F` and `ios\u002F` directories? | Full mobile feature set available |\n| Has `web\u002F` directory only? | Session Replay and Profiling unavailable |\n| Has `macos\u002F` directory? | Profiling available (alpha) |\n| Backend directory detected? | Trigger Phase 4 cross-link |\n\n---\n\n## Phase 2: Recommend\n\nPresent a concrete recommendation based on what you found. Don't ask open-ended questions — lead with a proposal:\n\n**Recommended (core coverage — always set up these):**\n- ✅ **Error Monitoring** — captures Dart exceptions, Flutter framework errors, and native crashes (iOS + Android)\n- ✅ **Tracing** — auto-instruments navigation, app start, network requests, and UI interactions\n- ✅ **Session Replay** — captures widget tree screenshots for debugging (iOS + Android only)\n\n**Optional (enhanced observability):**\n- ⚡ **Profiling** — CPU profiling; iOS and macOS only (alpha)\n- ⚡ **Logging** — structured logs via `Sentry.logger.*` and `sentry_logging` integration\n- ⚡ **Metrics** — counters, gauges, distributions (SDK ≥9.11.0)\n\n**Platform limitations — be upfront:**\n\n| Feature | Platforms | Notes |\n|---------|-----------|-------|\n| Session Replay | iOS, Android | Not available on macOS, Linux, Windows, Web |\n| Profiling | iOS, macOS | Alpha status; not available on Android, Linux, Windows, Web |\n| Native crashes | iOS, Android, macOS | NDK\u002Fsignal handling; Linux\u002FWindows\u002FWeb: Dart exceptions only |\n| App Start metrics | iOS, Android | Not available on desktop\u002Fweb |\n| Slow\u002Ffrozen frames | iOS, Android, macOS | Not available on Linux, Windows, Web |\n| Crons | N\u002FA | **Not available** in the Flutter\u002FDart SDK |\n\nPropose: *\"For your Flutter app targeting iOS\u002FAndroid, I recommend Error Monitoring + Tracing + Session Replay. Want me to also add Logging and Profiling (iOS\u002FmacOS alpha)?\"*\n\n---\n\n## Phase 3: Guide\n\n### Determine Your Setup Path\n\n| Project type | Recommended setup |\n|-------------|------------------|\n| Any Flutter app | Wizard CLI (handles pubspec, init, symbol upload) |\n| Manual preferred | Path B below — `pubspec.yaml` + `main.dart` |\n| Dart-only (CLI, server) | Path C below — pure `sentry` package |\n\n---\n\n### Path A: Wizard CLI (Recommended)\n\n> **You need to run this yourself** — the wizard opens a browser for login and requires interactive input that the agent can't handle. Copy-paste into your terminal:\n>\n> ```bash\n> brew install getsentry\u002Ftools\u002Fsentry-wizard && sentry-wizard -i flutter\n> ```\n>\n> It handles org\u002Fproject selection, adds `sentry_flutter` to `pubspec.yaml`, updates `main.dart`, configures `sentry_dart_plugin` for debug symbol upload, and adds build scripts. Here's what it creates\u002Fmodifies:\n>\n> | File | Action | Purpose |\n> |------|--------|---------|\n> | `pubspec.yaml` | Adds `sentry_flutter` dependency and `sentry:` config block | SDK + symbol upload config |\n> | `lib\u002Fmain.dart` | Wraps `main()` with `SentryFlutter.init()` | SDK initialization |\n> | `android\u002Fapp\u002Fbuild.gradle` | Adds Proguard config reference | Android obfuscation support |\n> | `.sentryclirc` | Auth token and org\u002Fproject config | Symbol upload credentials |\n>\n> **Once it finishes, come back and skip to [Verification](#verification).**\n\nIf the user skips the wizard, proceed with Path B (Manual Setup) below.\n\n---\n\n### Path B: Manual — Flutter App\n\n**Step 1 — Install**\n\n```bash\nflutter pub add sentry_flutter\n```\n\nOr add to `pubspec.yaml` manually:\n\n```yaml\ndependencies:\n  flutter:\n    sdk: flutter\n  sentry_flutter: ^9.14.0\n```\n\nThen run:\n\n```bash\nflutter pub get\n```\n\n**Step 2 — Initialize Sentry in `lib\u002Fmain.dart`**\n\n```dart\nimport 'package:flutter\u002Fwidgets.dart';\nimport 'package:sentry_flutter\u002Fsentry_flutter.dart';\n\nFuture\u003Cvoid> main() async {\n  await SentryFlutter.init(\n    (options) {\n      options.dsn = 'YOUR_SENTRY_DSN';\n      options.sendDefaultPii = true;\n\n      \u002F\u002F Tracing\n      options.tracesSampleRate = 1.0; \u002F\u002F lower to 0.1–0.2 in production\n\n      \u002F\u002F Profiling (iOS and macOS only — alpha)\n      options.profilesSampleRate = 1.0;\n\n      \u002F\u002F Session Replay (iOS and Android only)\n      options.replay.sessionSampleRate = 0.1;\n      options.replay.onErrorSampleRate = 1.0;\n\n      \u002F\u002F Structured Logging (SDK ≥9.5.0)\n      options.enableLogs = true;\n\n      options.environment = const bool.fromEnvironment('dart.vm.product')\n          ? 'production'\n          : 'development';\n    },\n    \u002F\u002F REQUIRED: wrap root widget to enable screenshots, replay, user interaction tracing\n    appRunner: () => runApp(SentryWidget(child: MyApp())),\n  );\n}\n```\n\n**Step 3 — Add Navigation Observer**\n\nAdd `SentryNavigatorObserver` to your `MaterialApp` or `CupertinoApp`:\n\n```dart\nimport 'package:flutter\u002Fmaterial.dart';\nimport 'package:sentry_flutter\u002Fsentry_flutter.dart';\n\nclass MyApp extends StatelessWidget {\n  @override\n  Widget build(BuildContext context) {\n    return MaterialApp(\n      navigatorObservers: [\n        SentryNavigatorObserver(),\n      ],\n      \u002F\u002F Always name your routes for Sentry to track them\n      routes: {\n        '\u002F': (context) => HomeScreen(),\n        '\u002Fprofile': (context) => ProfileScreen(),\n      },\n    );\n  }\n}\n```\n\nFor **GoRouter**:\n\n```dart\nimport 'package:go_router\u002Fgo_router.dart';\nimport 'package:sentry_flutter\u002Fsentry_flutter.dart';\n\nfinal GoRouter router = GoRouter(\n  observers: [SentryNavigatorObserver()],\n  routes: [\n    GoRoute(\n      path: '\u002F',\n      name: 'home', \u002F\u002F name is REQUIRED for Sentry route tracking\n      builder: (context, state) => const HomeScreen(),\n      routes: [\n        GoRoute(\n          path: 'profile\u002F:id',\n          name: 'profile', \u002F\u002F name is REQUIRED\n          builder: (context, state) => ProfileScreen(\n            id: state.pathParameters['id']!,\n          ),\n        ),\n      ],\n    ),\n  ],\n);\n```\n\n**Step 4 — Configure Debug Symbol Upload**\n\nReadable stack traces in Sentry require uploading debug symbols when building with `--obfuscate`.\n\nAdd to `pubspec.yaml`:\n\n```yaml\ndev_dependencies:\n  sentry_dart_plugin: ^3.2.1\n\nsentry:\n  project: YOUR_PROJECT_SLUG\n  org: YOUR_ORG_SLUG\n  auth_token: YOUR_AUTH_TOKEN  # prefer SENTRY_AUTH_TOKEN env var instead\n  upload_debug_symbols: true\n  upload_sources: true\n  upload_source_maps: true     # for Web\n```\n\nBuild and upload:\n\n```bash\n# Android\nflutter build apk \\\n  --release \\\n  --obfuscate \\\n  --split-debug-info=build\u002Fdebug-info \\\n  --extra-gen-snapshot-options=--save-obfuscation-map=build\u002Fapp\u002Fobfuscation.map.json\ndart run sentry_dart_plugin\n\n# iOS\nflutter build ipa \\\n  --release \\\n  --obfuscate \\\n  --split-debug-info=build\u002Fdebug-info \\\n  --extra-gen-snapshot-options=--save-obfuscation-map=build\u002Fapp\u002Fobfuscation.map.json\ndart run sentry_dart_plugin\n\n# Web\nflutter build web --release --source-maps\ndart run sentry_dart_plugin\n```\n\n---\n\n### Path C: Manual — Dart-Only (CLI \u002F Server)\n\n```yaml\n# pubspec.yaml\ndependencies:\n  sentry: ^9.14.0\n```\n\n```dart\nimport 'package:sentry\u002Fsentry.dart';\n\nFuture\u003Cvoid> main() async {\n  await Sentry.init(\n    (options) {\n      options.dsn = 'YOUR_SENTRY_DSN';\n      options.tracesSampleRate = 1.0;\n      options.enableLogs = true;\n    },\n    appRunner: myApp,\n  );\n}\n```\n\n---\n\n### Quick Reference: Full-Featured `SentryFlutter.init()`\n\n```dart\nimport 'package:sentry_flutter\u002Fsentry_flutter.dart';\n\nFuture\u003Cvoid> main() async {\n  await SentryFlutter.init(\n    (options) {\n      options.dsn = 'YOUR_SENTRY_DSN';\n      options.sendDefaultPii = true;\n\n      \u002F\u002F Environment — detect release builds via dart.vm.product\n      options.environment = const bool.fromEnvironment('dart.vm.product')\n          ? 'production'\n          : 'development';\n\n      \u002F\u002F Release is auto-set on iOS\u002FAndroid as \"packageName@version+build\"\n      \u002F\u002F Override if needed:\n      \u002F\u002F options.release = 'my-app@1.0.0+42';\n\n      \u002F\u002F Error sampling — reduce to drop a fraction of errors in high-volume production\n      options.sampleRate = 1.0;\n\n      \u002F\u002F Tracing — lower to 0.1–0.2 in high-traffic production\n      options.tracesSampleRate = 1.0;\n\n      \u002F\u002F Profiling — iOS and macOS only (alpha); relative to tracesSampleRate\n      options.profilesSampleRate = 1.0;\n\n      \u002F\u002F Session Replay — iOS and Android only (SDK ≥9.0.0)\n      options.replay.sessionSampleRate = 0.1;   \u002F\u002F record 10% of all sessions\n      options.replay.onErrorSampleRate = 1.0;   \u002F\u002F always record error sessions\n\n      \u002F\u002F Privacy defaults — all text and images masked\n      options.privacy.maskAllText = true;\n      options.privacy.maskAllImages = true;\n\n      \u002F\u002F Structured logging (SDK ≥9.5.0)\n      options.enableLogs = true;\n\n      \u002F\u002F Attachments\n      options.attachScreenshot = true;          \u002F\u002F screenshot on error\n      options.attachViewHierarchy = true;       \u002F\u002F widget tree on error\n\n      \u002F\u002F HTTP client\n      options.captureFailedRequests = true;     \u002F\u002F auto-capture HTTP errors\n      options.maxRequestBodySize = MaxRequestBodySize.small;\n\n      \u002F\u002F Android specifics\n      options.anrEnabled = true;                \u002F\u002F ANR detection\n      options.enableNdkScopeSync = true;        \u002F\u002F sync scope to native\n      options.enableTombstone = false;          \u002F\u002F Android 12+ tombstone (opt-in)\n\n      \u002F\u002F Navigation (Time to Full Display — opt-in)\n      options.enableTimeToFullDisplayTracing = true;\n    },\n    appRunner: () => runApp(SentryWidget(child: MyApp())),\n  );\n}\n```\n\n---\n\n### Navigation: Time to Full Display (TTFD)\n\nTTID (Time to Initial Display) is always enabled. TTFD is opt-in:\n\n```dart\n\u002F\u002F Enable in options:\noptions.enableTimeToFullDisplayTracing = true;\n```\n\nThen report when your screen has loaded its data:\n\n```dart\n\u002F\u002F Option 1: Widget wrapper (marks TTFD when child first renders)\nSentryDisplayWidget(child: MyWidget())\n\n\u002F\u002F Option 2: Manual API call (after async data loads)\nawait _loadData();\nSentryFlutter.currentDisplay()?.reportFullyDisplayed();\n```\n\n---\n\n### For Each Agreed Feature\n\nWalk through features one at a time. Load the reference file for each, follow its steps, then verify before moving on:\n\n| Feature | Reference | Load when... |\n|---------|-----------|-------------|\n| Error Monitoring | `${SKILL_ROOT}\u002Freferences\u002Ferror-monitoring.md` | Always (baseline) |\n| Tracing & Performance | `${SKILL_ROOT}\u002Freferences\u002Ftracing.md` | Always — navigation, HTTP, DB spans |\n| Session Replay | `${SKILL_ROOT}\u002Freferences\u002Fsession-replay.md` | iOS\u002FAndroid user-facing apps |\n| Profiling | `${SKILL_ROOT}\u002Freferences\u002Fprofiling.md` | iOS\u002FmacOS performance-sensitive apps |\n| Logging | `${SKILL_ROOT}\u002Freferences\u002Flogging.md` | Structured logging \u002F log-trace correlation |\n| Metrics | `${SKILL_ROOT}\u002Freferences\u002Fmetrics.md` | Custom business metrics |\n| Ecosystem Integrations | `${SKILL_ROOT}\u002Freferences\u002Fecosystem-integrations.md` | HTTP clients, databases, GraphQL, state management |\n\nFor each feature: `Read ${SKILL_ROOT}\u002Freferences\u002F\u003Cfeature>.md`, follow steps exactly, verify it works.\n\n---\n\n## Configuration Reference\n\n### Core `SentryFlutter.init()` Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `dsn` | `string` | — | **Required.** Project DSN. Env: `SENTRY_DSN` via `--dart-define` |\n| `environment` | `string` | — | e.g., `\"production\"`, `\"staging\"`. Env: `SENTRY_ENVIRONMENT` |\n| `release` | `string` | Auto on iOS\u002FAndroid | `\"packageName@version+build\"`. Env: `SENTRY_RELEASE` |\n| `dist` | `string` | — | Distribution identifier; max 64 chars. Env: `SENTRY_DIST` |\n| `sendDefaultPii` | `bool` | `false` | Include PII: IP address, user labels, widget text in replay |\n| `sampleRate` | `double` | `1.0` | Error event sampling (0.0–1.0) |\n| `maxBreadcrumbs` | `int` | `100` | Max breadcrumbs per event |\n| `attachStacktrace` | `bool` | `true` | Auto-attach stack traces to messages |\n| `attachScreenshot` | `bool` | `false` | Capture screenshot on error (mobile\u002Fdesktop only) |\n| `screenshotQuality` | enum | `high` | Screenshot quality: `full`, `high`, `medium`, `low` |\n| `attachViewHierarchy` | `bool` | `false` | Attach JSON widget tree as attachment on error |\n| `debug` | `bool` | `true` in debug | Verbose SDK output. **Never force `true` in production** |\n| `diagnosticLevel` | enum | `warning` | Log verbosity: `debug`, `info`, `warning`, `error`, `fatal` |\n| `enabled` | `bool` | `true` | Disable SDK entirely (e.g., for testing) |\n| `maxCacheItems` | `int` | `30` | Max offline-cached envelopes (not supported on Web) |\n| `sendClientReports` | `bool` | `true` | Send SDK health reports (dropped events, etc.) |\n| `reportPackages` | `bool` | `true` | Report `pubspec.yaml` dependency list |\n| `reportSilentFlutterErrors` | `bool` | `false` | Capture `FlutterErrorDetails.silent` errors |\n| `idleTimeout` | `Duration` | `3000ms` | Auto-finish idle user interaction transactions |\n\n### Tracing Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `tracesSampleRate` | `double` | — | Transaction sample rate (0–1). Enable by setting >0 |\n| `tracesSampler` | `function` | — | Per-transaction sampling; overrides `tracesSampleRate` |\n| `tracePropagationTargets` | `List` | — | URLs to attach `sentry-trace` + `baggage` headers |\n| `propagateTraceparent` | `bool` | `false` | Also send W3C `traceparent` header (SDK ≥9.7.0) |\n| `enableTimeToFullDisplayTracing` | `bool` | `false` | Opt-in TTFD tracking per screen |\n| `enableAutoPerformanceTracing` | `bool` | `true` | Auto-enable performance monitoring |\n| `enableUserInteractionTracing` | `bool` | `true` | Create transactions for tap\u002Fclick\u002Flong-press events |\n| `enableUserInteractionBreadcrumbs` | `bool` | `true` | Breadcrumbs for every tracked user interaction |\n\n### Profiling Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `profilesSampleRate` | `double` | — | Profiling rate relative to `tracesSampleRate`. **iOS\u002FmacOS only** |\n\n### Native \u002F Mobile Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `autoInitializeNativeSdk` | `bool` | `true` | Auto-initialize native Android\u002FiOS SDK layer |\n| `enableNativeCrashHandling` | `bool` | `true` | Capture native crashes (NDK, signal, Mach exception) |\n| `enableNdkScopeSync` | `bool` | `true` | Sync Dart scope to Android NDK |\n| `enableScopeSync` | `bool` | `true` | Sync scope data to native SDKs |\n| `anrEnabled` | `bool` | `true` | ANR detection (Android) |\n| `anrTimeoutInterval` | `int` | `5000` | ANR timeout in milliseconds (Android) |\n| `enableWatchdogTerminationTracking` | `bool` | `true` | OOM kill tracking (iOS) |\n| `enableTombstone` | `bool` | `false` | Android 12+ native crash info via `ApplicationExitInfo` |\n| `attachThreads` | `bool` | `false` | Attach all threads on crash (Android) |\n| `captureNativeFailedRequests` | `bool` | — | Native HTTP error capture, independent of Dart client (iOS\u002FmacOS, v9.11.0+) |\n| `enableAutoNativeAppStart` | `bool` | `true` | App start timing instrumentation (iOS\u002FAndroid) |\n| `enableFramesTracking` | `bool` | `true` | Slow\u002Ffrozen frame monitoring (iOS\u002FAndroid\u002FmacOS) |\n| `proguardUuid` | `string` | — | Proguard UUID for Android obfuscation mapping |\n\n### Session & Release Health Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `enableAutoSessionTracking` | `bool` | `true` | Session tracking for crash-free user\u002Fsession metrics |\n| `autoSessionTrackingInterval` | `Duration` | `30s` | Background inactivity before session ends |\n\n### Replay Options (`options.replay`)\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `replay.sessionSampleRate` | `double` | `0.0` | Fraction of all sessions recorded |\n| `replay.onErrorSampleRate` | `double` | `0.0` | Fraction of error sessions recorded |\n\n### Replay Privacy Options (`options.privacy`)\n\n| Option \u002F Method | Default | Purpose |\n|-----------------|---------|---------|\n| `privacy.maskAllText` | `true` | Mask all text widget content |\n| `privacy.maskAllImages` | `true` | Mask all image widgets |\n| `privacy.maskAssetImages` | `true` | Mask images from root asset bundle |\n| `privacy.mask\u003CT>()` | — | Mask a specific widget type and all subclasses |\n| `privacy.unmask\u003CT>()` | — | Unmask a specific widget type |\n| `privacy.maskCallback\u003CT>()` | — | Custom masking decision per widget instance |\n\n### HTTP Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `captureFailedRequests` | `bool` | `true` (Flutter) | Auto-capture HTTP errors |\n| `maxRequestBodySize` | enum | `never` | Body capture: `never`, `small`, `medium`, `always` |\n| `failedRequestStatusCodes` | `List` | `[500–599]` | Status codes treated as failures |\n| `failedRequestTargets` | `List` | `['.*']` | URL patterns to monitor |\n\n### Hook Options\n\n| Option | Type | Purpose |\n|--------|------|---------|\n| `beforeSend` | `(SentryEvent, Hint) → SentryEvent?` | Modify or drop error events. Return `null` to drop |\n| `beforeSendTransaction` | `(SentryEvent) → SentryEvent?` | Modify or drop transaction events |\n| `beforeBreadcrumb` | `(Breadcrumb, Hint) → Breadcrumb?` | Process breadcrumbs before storage |\n| `beforeSendLog` | `(SentryLog) → SentryLog?` | Filter structured logs before sending |\n\n### Environment Variables\n\nPass via `--dart-define` at build time:\n\n| Variable | Purpose | Notes |\n|----------|---------|-------|\n| `SENTRY_DSN` | Data Source Name | Falls back from `options.dsn` |\n| `SENTRY_ENVIRONMENT` | Deployment environment | Falls back from `options.environment` |\n| `SENTRY_RELEASE` | Release identifier | Falls back from `options.release` |\n| `SENTRY_DIST` | Build distribution | Falls back from `options.dist` |\n| `SENTRY_AUTH_TOKEN` | Upload debug symbols | **Never embed in app — build tool only** |\n| `SENTRY_ORG` | Organization slug | Used by `sentry_dart_plugin` |\n| `SENTRY_PROJECT` | Project slug | Used by `sentry_dart_plugin` |\n\nUsage:\n\n```bash\nflutter build apk --release \\\n  --dart-define=SENTRY_DSN=https:\u002F\u002Fxxx@sentry.io\u002F123 \\\n  --dart-define=SENTRY_ENVIRONMENT=production\n```\n\nThen in code:\n\n```dart\noptions.dsn = const String.fromEnvironment('SENTRY_DSN');\noptions.environment = const String.fromEnvironment('SENTRY_ENVIRONMENT', defaultValue: 'development');\n```\n\n### Production Settings\n\nLower sample rates and harden config before shipping:\n\n```dart\nFuture\u003Cvoid> main() async {\n  final isProduction = const bool.fromEnvironment('dart.vm.product');\n\n  await SentryFlutter.init(\n    (options) {\n      options.dsn = const String.fromEnvironment('SENTRY_DSN');\n      options.environment = isProduction ? 'production' : 'development';\n\n      \u002F\u002F Trace 10% of transactions in high-traffic production\n      options.tracesSampleRate = isProduction ? 0.1 : 1.0;\n\n      \u002F\u002F Profile 100% of traced transactions (profiling is always a subset)\n      options.profilesSampleRate = 1.0;\n\n      \u002F\u002F Replay all error sessions, sample 5% of normal sessions\n      options.replay.onErrorSampleRate = 1.0;\n      options.replay.sessionSampleRate = isProduction ? 0.05 : 1.0;\n\n      \u002F\u002F Disable debug logging in production\n      options.debug = !isProduction;\n    },\n    appRunner: () => runApp(SentryWidget(child: MyApp())),\n  );\n}\n```\n\n### Default Auto-Enabled Integrations\n\nThese are active with no extra config when you call `SentryFlutter.init()`:\n\n| Integration | What it does |\n|-------------|-------------|\n| `FlutterErrorIntegration` | Captures `FlutterError.onError` framework errors |\n| `RunZonedGuardedIntegration` | Catches unhandled Dart exceptions in runZonedGuarded |\n| `NativeAppStartIntegration` | App start timing (iOS\u002FAndroid) |\n| `FramesTrackingIntegration` | Slow\u002Ffrozen frames (iOS\u002FAndroid\u002FmacOS) |\n| `NativeUserInteractionIntegration` | User interaction breadcrumbs from native layer |\n| `UserInteractionIntegration` | Dart-layer tap\u002Fclick transactions (requires `SentryWidget`) |\n| `DeviceContextIntegration` | Device model, OS version, screen resolution |\n| `AppContextIntegration` | App version, build number, bundle ID |\n| `ConnectivityIntegration` | Network connectivity change breadcrumbs |\n| `HttpClientIntegration` | Auto-instrument Dart `http` requests |\n| `SdkIntegration` | SDK metadata tagging |\n| `ReleaseIntegration` | Auto-set release on iOS\u002FAndroid from package info |\n\n---\n\n## Verification\n\nAfter setup, test that Sentry is receiving events:\n\n```dart\n\u002F\u002F Add a test button somewhere visible during development:\nElevatedButton(\n  onPressed: () {\n    throw Exception('Sentry test error!');\n  },\n  child: const Text('Test Sentry Error'),\n)\n\n\u002F\u002F Or capture manually:\nElevatedButton(\n  onPressed: () {\n    Sentry.captureMessage('Sentry test message', level: SentryLevel.info);\n  },\n  child: const Text('Test Sentry Message'),\n)\n\n\u002F\u002F Test structured logging:\nElevatedButton(\n  onPressed: () {\n    Sentry.logger.info('Test log from Flutter app');\n  },\n  child: const Text('Test Sentry Log'),\n)\n```\n\n**Check the Sentry dashboard:**\n- **Issues** → test error should appear within seconds\n- **Traces** → look for a navigation transaction with child spans\n- **Replays** → session recording visible after app interaction (iOS\u002FAndroid only)\n- **Logs** → structured log entries if `enableLogs: true`\n\n> ⚠️ **Platform limitations in debug mode:**\n> - Native crashes, session replay, slow\u002Ffrozen frames, and app start metrics only fully work in release builds on iOS\u002FAndroid\n> - Run `flutter run --release` or use a real device\u002Femulator to test native features\n> - Debug mode uses the Dart VM with JIT compilation — some native integrations behave differently\n\n---\n\n## Phase 4: Cross-Link\n\nAfter completing Flutter setup, check for a backend missing Sentry coverage:\n\n```bash\n# Adjacent backend directories\nls ..\u002Fbackend ..\u002Fserver ..\u002Fapi 2>\u002Fdev\u002Fnull\ncat ..\u002Fgo.mod 2>\u002Fdev\u002Fnull | head -3\ncat ..\u002Frequirements.txt ..\u002Fpyproject.toml 2>\u002Fdev\u002Fnull | head -3\ncat ..\u002FGemfile 2>\u002Fdev\u002Fnull | head -3\nls ..\u002Fbackend\u002Fpackage.json ..\u002Fserver\u002Fpackage.json 2>\u002Fdev\u002Fnull\n```\n\nIf a backend exists without Sentry, suggest the matching skill:\n\n| Detected | Suggest skill |\n|----------|--------------|\n| Go backend (`go.mod`) | `sentry-go-sdk` |\n| Python backend (`requirements.txt`, `pyproject.toml`) | `sentry-python-sdk` |\n| Ruby backend (`Gemfile`) | `sentry-ruby-sdk` |\n| Node.js backend | `sentry-node-sdk` |\n| .NET backend (`*.csproj`) | `sentry-dotnet-sdk` |\n| React \u002F Next.js web | `sentry-react-sdk` \u002F `sentry-nextjs-sdk` |\n\n**Distributed tracing** — if a backend skill is added, configure `tracePropagationTargets` in Flutter to propagate trace context to your API:\n\n```dart\noptions.tracePropagationTargets = ['api.myapp.com', 'localhost'];\noptions.propagateTraceparent = true; \u002F\u002F also send W3C traceparent header\n```\n\nThis links mobile transactions to backend traces in the Sentry waterfall view.\n\n---\n\n## Troubleshooting\n\n| Issue | Solution |\n|-------|----------|\n| Events not appearing in Sentry | Set `options.debug = true` — SDK logs to Flutter console; verify DSN is correct |\n| `SentryFlutter.init` throws | Ensure `main()` is `async` and you `await SentryFlutter.init(...)` |\n| Stack traces unreadable in Sentry | Upload debug symbols with `sentry_dart_plugin`; build with `--obfuscate --split-debug-info` |\n| Stack traces missing on Web | Build with `--source-maps` and run `dart run sentry_dart_plugin` to upload |\n| Native crashes not captured | Confirm `enableNativeCrashHandling: true`; test in release mode, not debug |\n| Session replay not recording | iOS\u002FAndroid only; confirm `SentryWidget` wraps root; check `replay.onErrorSampleRate` |\n| Replay shows blank screens | Confirm `SentryWidget(child: MyApp())` is outermost widget; not inside navigator |\n| Profiling not working | iOS and macOS only (alpha); confirm `tracesSampleRate > 0` is set first |\n| Navigation not tracked | Add `SentryNavigatorObserver()` to `navigatorObservers`; name all routes |\n| GoRouter routes unnamed | Add `name:` to all `GoRoute` entries — unnamed routes are tracked as `null` |\n| TTFD never reports | Call `SentryFlutter.currentDisplay()?.reportFullyDisplayed()` after data loads, or wrap with `SentryDisplayWidget` |\n| `sentry_dart_plugin` auth error | Set `SENTRY_AUTH_TOKEN` env var instead of hardcoding in `pubspec.yaml` |\n| Android ProGuard mapping missing | Ensure `--extra-gen-snapshot-options=--save-obfuscation-map=...` flag is set |\n| iOS dSYM not uploaded | `sentry_dart_plugin` handles this; check `upload_debug_symbols: true` in `pubspec.yaml` `sentry:` block |\n| `pub get` fails: Dart SDK too old | `sentry_flutter` ≥9.0.0 requires Dart ≥3.5.0; run `flutter upgrade` |\n| Hot restart crashes on Android debug | Known issue (fixed in SDK ≥9.9.0); upgrade if on older version |\n| ANR detection too aggressive | Increase `anrTimeoutInterval` (default: 5000ms) |\n| Too many transactions in dashboard | Lower `tracesSampleRate` to `0.1` or use `tracesSampler` to drop health checks |\n| `beforeSend` not firing for native crashes | Expected — `beforeSend` intercepts only Dart-layer events; native crashes bypass it |\n| Crons not available | The Flutter\u002FDart SDK does not support Sentry Crons; use a server-side SDK instead |\n| `SentryWidget` warning in tests | Wrap test widget with `SentryFlutter.init()` in `setUpAll`, or use `enabled: false` |\n| Firebase Remote Config: Linux\u002FWindows | `sentry_firebase_remote_config` not supported on Linux\u002FWindows (Firebase limitation) |\n| Isar tracing on Web | `sentry_isar` does NOT support Web (Isar does not support Web) |\n","> [All Skills](..\u002F..\u002FSKILL_TREE.md) > [SDK Setup](..\u002Fsentry-sdk-setup\u002FSKILL.md) > Flutter SDK\n\n# Sentry Flutter SDK\n\nOpinionated wizard that scans your Flutter or Dart project and guides you through complete Sentry setup — error monitoring, tracing, session replay, logging, profiling, and ecosystem integrations.\n\n## Invoke This Skill When\n\n- User asks to \"add Sentry to Flutter\" or \"set up Sentry\" in a Flutter or Dart app\n- User wants error monitoring, tracing, profiling, session replay, or logging in Flutter\n- User mentions `sentry_flutter`, `sentry_dart`, mobile error tracking, or Sentry for Flutter\n- User wants to monitor native crashes, ANRs, or app hangs on iOS\u002FAndroid\n\n> **Note:** SDK versions and APIs below reflect `sentry_flutter` ≥9.14.0 (current stable, February 2026).\n> Always verify against [docs.sentry.io\u002Fplatforms\u002Fflutter\u002F](https:\u002F\u002Fdocs.sentry.io\u002Fplatforms\u002Fflutter\u002F) before implementing.\n\n---\n\n## Phase 1: Detect\n\nRun these commands to understand the project before making any recommendations:\n\n```bash\n# Detect Flutter project type and existing Sentry\ncat pubspec.yaml | grep -E '(sentry|flutter|dart)'\n\n# Check SDK version\ncat pubspec.yaml | grep -A2 'environment:'\n\n# Check for existing Sentry initialization\ngrep -r \"SentryFlutter.init\\|Sentry.init\" lib\u002F 2>\u002Fdev\u002Fnull | head -5\n\n# Detect navigation library\ngrep -E '(go_router|auto_route|get:|beamer|routemaster)' pubspec.yaml\n\n# Detect HTTP client\ngrep -E '(dio:|http:|chopper:)' pubspec.yaml\n\n# Detect database packages\ngrep -E '(sqflite|drift|hive|isar|floor)' pubspec.yaml\n\n# Detect state management (for integration patterns)\ngrep -E '(flutter_bloc|riverpod|provider:|get:)' pubspec.yaml\n\n# Detect GraphQL\ngrep -E '(graphql|ferry|gql)' pubspec.yaml\n\n# Detect Firebase\ngrep -E '(firebase_core|supabase)' pubspec.yaml\n\n# Detect backend for cross-link\nls ..\u002Fbackend\u002F ..\u002Fserver\u002F ..\u002Fapi\u002F 2>\u002Fdev\u002Fnull\nfind .. -maxdepth 3 \\( -name \"go.mod\" -o -name \"requirements.txt\" -o -name \"Gemfile\" -o -name \"*.csproj\" \\) 2>\u002Fdev\u002Fnull | grep -v flutter | head -10\n\n# Detect platform targets\nls android\u002F ios\u002F macos\u002F linux\u002F windows\u002F web\u002F 2>\u002Fdev\u002Fnull\n```\n\n**What to determine:**\n\n| Question | Impact |\n|----------|--------|\n| `sentry_flutter` already in `pubspec.yaml`? | Skip install, jump to feature config |\n| Dart SDK `>=3.5`? | Required for `sentry_flutter` ≥9.0.0 |\n| `go_router` or `auto_route` present? | Use `SentryNavigatorObserver` — specific patterns apply |\n| `dio` present? | Recommend `sentry_dio` integration |\n| `sqflite`, `drift`, `hive`, `isar` present? | Recommend matching `sentry_*` DB package |\n| Has `android\u002F` and `ios\u002F` directories? | Full mobile feature set available |\n| Has `web\u002F` directory only? | Session Replay and Profiling unavailable |\n| Has `macos\u002F` directory? | Profiling available (alpha) |\n| Backend directory detected? | Trigger Phase 4 cross-link |\n\n---\n\n## Phase 2: Recommend\n\nPresent a concrete recommendation based on what you found. Don't ask open-ended questions — lead with a proposal:\n\n**Recommended (core coverage — always set up these):**\n- ✅ **Error Monitoring** — captures Dart exceptions, Flutter framework errors, and native crashes (iOS + Android)\n- ✅ **Tracing** — auto-instruments navigation, app start, network requests, and UI interactions\n- ✅ **Session Replay** — captures widget tree screenshots for debugging (iOS + Android only)\n\n**Optional (enhanced observability):**\n- ⚡ **Profiling** — CPU profiling; iOS and macOS only (alpha)\n- ⚡ **Logging** — structured logs via `Sentry.logger.*` and `sentry_logging` integration\n- ⚡ **Metrics** — counters, gauges, distributions (SDK ≥9.11.0)\n\n**Platform limitations — be upfront:**\n\n| Feature | Platforms | Notes |\n|---------|-----------|-------|\n| Session Replay | iOS, Android | Not available on macOS, Linux, Windows, Web |\n| Profiling | iOS, macOS | Alpha status; not available on Android, Linux, Windows, Web |\n| Native crashes | iOS, Android, macOS | NDK\u002Fsignal handling; Linux\u002FWindows\u002FWeb: Dart exceptions only |\n| App Start metrics | iOS, Android | Not available on desktop\u002Fweb |\n| Slow\u002Ffrozen frames | iOS, Android, macOS | Not available on Linux, Windows, Web |\n| Crons | N\u002FA | **Not available** in the Flutter\u002FDart SDK |\n\nPropose: *\"For your Flutter app targeting iOS\u002FAndroid, I recommend Error Monitoring + Tracing + Session Replay. Want me to also add Logging and Profiling (iOS\u002FmacOS alpha)?\"*\n\n---\n\n## Phase 3: Guide\n\n### Determine Your Setup Path\n\n| Project type | Recommended setup |\n|-------------|------------------|\n| Any Flutter app | Wizard CLI (handles pubspec, init, symbol upload) |\n| Manual preferred | Path B below — `pubspec.yaml` + `main.dart` |\n| Dart-only (CLI, server) | Path C below — pure `sentry` package |\n\n---\n\n### Path A: Wizard CLI (Recommended)\n\n> **You need to run this yourself** — the wizard opens a browser for login and requires interactive input that the agent can't handle. Copy-paste into your terminal:\n>\n> ```bash\n> brew install getsentry\u002Ftools\u002Fsentry-wizard && sentry-wizard -i flutter\n> ```\n>\n> It handles org\u002Fproject selection, adds `sentry_flutter` to `pubspec.yaml`, updates `main.dart`, configures `sentry_dart_plugin` for debug symbol upload, and adds build scripts. Here's what it creates\u002Fmodifies:\n>\n> | File | Action | Purpose |\n> |------|--------|---------|\n> | `pubspec.yaml` | Adds `sentry_flutter` dependency and `sentry:` config block | SDK + symbol upload config |\n> | `lib\u002Fmain.dart` | Wraps `main()` with `SentryFlutter.init()` | SDK initialization |\n> | `android\u002Fapp\u002Fbuild.gradle` | Adds Proguard config reference | Android obfuscation support |\n> | `.sentryclirc` | Auth token and org\u002Fproject config | Symbol upload credentials |\n>\n> **Once it finishes, come back and skip to [Verification](#verification).**\n\nIf the user skips the wizard, proceed with Path B (Manual Setup) below.\n\n---\n\n### Path B: Manual — Flutter App\n\n**Step 1 — Install**\n\n```bash\nflutter pub add sentry_flutter\n```\n\nOr add to `pubspec.yaml` manually:\n\n```yaml\ndependencies:\n  flutter:\n    sdk: flutter\n  sentry_flutter: ^9.14.0\n```\n\nThen run:\n\n```bash\nflutter pub get\n```\n\n**Step 2 — Initialize Sentry in `lib\u002Fmain.dart`**\n\n```dart\nimport 'package:flutter\u002Fwidgets.dart';\nimport 'package:sentry_flutter\u002Fsentry_flutter.dart';\n\nFuture\u003Cvoid> main() async {\n  await SentryFlutter.init(\n    (options) {\n      options.dsn = 'YOUR_SENTRY_DSN';\n      options.sendDefaultPii = true;\n\n      \u002F\u002F Tracing\n      options.tracesSampleRate = 1.0; \u002F\u002F lower to 0.1–0.2 in production\n\n      \u002F\u002F Profiling (iOS and macOS only — alpha)\n      options.profilesSampleRate = 1.0;\n\n      \u002F\u002F Session Replay (iOS and Android only)\n      options.replay.sessionSampleRate = 0.1;\n      options.replay.onErrorSampleRate = 1.0;\n\n      \u002F\u002F Structured Logging (SDK ≥9.5.0)\n      options.enableLogs = true;\n\n      options.environment = const bool.fromEnvironment('dart.vm.product')\n          ? 'production'\n          : 'development';\n    },\n    \u002F\u002F REQUIRED: wrap root widget to enable screenshots, replay, user interaction tracing\n    appRunner: () => runApp(SentryWidget(child: MyApp())),\n  );\n}\n```\n\n**Step 3 — Add Navigation Observer**\n\nAdd `SentryNavigatorObserver` to your `MaterialApp` or `CupertinoApp`:\n\n```dart\nimport 'package:flutter\u002Fmaterial.dart';\nimport 'package:sentry_flutter\u002Fsentry_flutter.dart';\n\nclass MyApp extends StatelessWidget {\n  @override\n  Widget build(BuildContext context) {\n    return MaterialApp(\n      navigatorObservers: [\n        SentryNavigatorObserver(),\n      ],\n      \u002F\u002F Always name your routes for Sentry to track them\n      routes: {\n        '\u002F': (context) => HomeScreen(),\n        '\u002Fprofile': (context) => ProfileScreen(),\n      },\n    );\n  }\n}\n```\n\nFor **GoRouter**:\n\n```dart\nimport 'package:go_router\u002Fgo_router.dart';\nimport 'package:sentry_flutter\u002Fsentry_flutter.dart';\n\nfinal GoRouter router = GoRouter(\n  observers: [SentryNavigatorObserver()],\n  routes: [\n    GoRoute(\n      path: '\u002F',\n      name: 'home', \u002F\u002F name is REQUIRED for Sentry route tracking\n      builder: (context, state) => const HomeScreen(),\n      routes: [\n        GoRoute(\n          path: 'profile\u002F:id',\n          name: 'profile', \u002F\u002F name is REQUIRED\n          builder: (context, state) => ProfileScreen(\n            id: state.pathParameters['id']!,\n          ),\n        ),\n      ],\n    ),\n  ],\n);\n```\n\n**Step 4 — Configure Debug Symbol Upload**\n\nReadable stack traces in Sentry require uploading debug symbols when building with `--obfuscate`.\n\nAdd to `pubspec.yaml`:\n\n```yaml\ndev_dependencies:\n  sentry_dart_plugin: ^3.2.1\n\nsentry:\n  project: YOUR_PROJECT_SLUG\n  org: YOUR_ORG_SLUG\n  auth_token: YOUR_AUTH_TOKEN  # prefer SENTRY_AUTH_TOKEN env var instead\n  upload_debug_symbols: true\n  upload_sources: true\n  upload_source_maps: true     # for Web\n```\n\nBuild and upload:\n\n```bash\n# Android\nflutter build apk \\\n  --release \\\n  --obfuscate \\\n  --split-debug-info=build\u002Fdebug-info \\\n  --extra-gen-snapshot-options=--save-obfuscation-map=build\u002Fapp\u002Fobfuscation.map.json\ndart run sentry_dart_plugin\n\n# iOS\nflutter build ipa \\\n  --release \\\n  --obfuscate \\\n  --split-debug-info=build\u002Fdebug-info \\\n  --extra-gen-snapshot-options=--save-obfuscation-map=build\u002Fapp\u002Fobfuscation.map.json\ndart run sentry_dart_plugin\n\n# Web\nflutter build web --release --source-maps\ndart run sentry_dart_plugin\n```\n\n---\n\n### Path C: Manual — Dart-Only (CLI \u002F Server)\n\n```yaml\n# pubspec.yaml\ndependencies:\n  sentry: ^9.14.0\n```\n\n```dart\nimport 'package:sentry\u002Fsentry.dart';\n\nFuture\u003Cvoid> main() async {\n  await Sentry.init(\n    (options) {\n      options.dsn = 'YOUR_SENTRY_DSN';\n      options.tracesSampleRate = 1.0;\n      options.enableLogs = true;\n    },\n    appRunner: myApp,\n  );\n}\n```\n\n---\n\n### Quick Reference: Full-Featured `SentryFlutter.init()`\n\n```dart\nimport 'package:sentry_flutter\u002Fsentry_flutter.dart';\n\nFuture\u003Cvoid> main() async {\n  await SentryFlutter.init(\n    (options) {\n      options.dsn = 'YOUR_SENTRY_DSN';\n      options.sendDefaultPii = true;\n\n      \u002F\u002F Environment — detect release builds via dart.vm.product\n      options.environment = const bool.fromEnvironment('dart.vm.product')\n          ? 'production'\n          : 'development';\n\n      \u002F\u002F Release is auto-set on iOS\u002FAndroid as \"packageName@version+build\"\n      \u002F\u002F Override if needed:\n      \u002F\u002F options.release = 'my-app@1.0.0+42';\n\n      \u002F\u002F Error sampling — reduce to drop a fraction of errors in high-volume production\n      options.sampleRate = 1.0;\n\n      \u002F\u002F Tracing — lower to 0.1–0.2 in high-traffic production\n      options.tracesSampleRate = 1.0;\n\n      \u002F\u002F Profiling — iOS and macOS only (alpha); relative to tracesSampleRate\n      options.profilesSampleRate = 1.0;\n\n      \u002F\u002F Session Replay — iOS and Android only (SDK ≥9.0.0)\n      options.replay.sessionSampleRate = 0.1;   \u002F\u002F record 10% of all sessions\n      options.replay.onErrorSampleRate = 1.0;   \u002F\u002F always record error sessions\n\n      \u002F\u002F Privacy defaults — all text and images masked\n      options.privacy.maskAllText = true;\n      options.privacy.maskAllImages = true;\n\n      \u002F\u002F Structured logging (SDK ≥9.5.0)\n      options.enableLogs = true;\n\n      \u002F\u002F Attachments\n      options.attachScreenshot = true;          \u002F\u002F screenshot on error\n      options.attachViewHierarchy = true;       \u002F\u002F widget tree on error\n\n      \u002F\u002F HTTP client\n      options.captureFailedRequests = true;     \u002F\u002F auto-capture HTTP errors\n      options.maxRequestBodySize = MaxRequestBodySize.small;\n\n      \u002F\u002F Android specifics\n      options.anrEnabled = true;                \u002F\u002F ANR detection\n      options.enableNdkScopeSync = true;        \u002F\u002F sync scope to native\n      options.enableTombstone = false;          \u002F\u002F Android 12+ tombstone (opt-in)\n\n      \u002F\u002F Navigation (Time to Full Display — opt-in)\n      options.enableTimeToFullDisplayTracing = true;\n    },\n    appRunner: () => runApp(SentryWidget(child: MyApp())),\n  );\n}\n```\n\n---\n\n### Navigation: Time to Full Display (TTFD)\n\nTTID (Time to Initial Display) is always enabled. TTFD is opt-in:\n\n```dart\n\u002F\u002F Enable in options:\noptions.enableTimeToFullDisplayTracing = true;\n```\n\nThen report when your screen has loaded its data:\n\n```dart\n\u002F\u002F Option 1: Widget wrapper (marks TTFD when child first renders)\nSentryDisplayWidget(child: MyWidget())\n\n\u002F\u002F Option 2: Manual API call (after async data loads)\nawait _loadData();\nSentryFlutter.currentDisplay()?.reportFullyDisplayed();\n```\n\n---\n\n### For Each Agreed Feature\n\nWalk through features one at a time. Load the reference file for each, follow its steps, then verify before moving on:\n\n| Feature | Reference | Load when... |\n|---------|-----------|-------------|\n| Error Monitoring | `${SKILL_ROOT}\u002Freferences\u002Ferror-monitoring.md` | Always (baseline) |\n| Tracing & Performance | `${SKILL_ROOT}\u002Freferences\u002Ftracing.md` | Always — navigation, HTTP, DB spans |\n| Session Replay | `${SKILL_ROOT}\u002Freferences\u002Fsession-replay.md` | iOS\u002FAndroid user-facing apps |\n| Profiling | `${SKILL_ROOT}\u002Freferences\u002Fprofiling.md` | iOS\u002FmacOS performance-sensitive apps |\n| Logging | `${SKILL_ROOT}\u002Freferences\u002Flogging.md` | Structured logging \u002F log-trace correlation |\n| Metrics | `${SKILL_ROOT}\u002Freferences\u002Fmetrics.md` | Custom business metrics |\n| Ecosystem Integrations | `${SKILL_ROOT}\u002Freferences\u002Fecosystem-integrations.md` | HTTP clients, databases, GraphQL, state management |\n\nFor each feature: `Read ${SKILL_ROOT}\u002Freferences\u002F\u003Cfeature>.md`, follow steps exactly, verify it works.\n\n---\n\n## Configuration Reference\n\n### Core `SentryFlutter.init()` Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `dsn` | `string` | — | **Required.** Project DSN. Env: `SENTRY_DSN` via `--dart-define` |\n| `environment` | `string` | — | e.g., `\"production\"`, `\"staging\"`. Env: `SENTRY_ENVIRONMENT` |\n| `release` | `string` | Auto on iOS\u002FAndroid | `\"packageName@version+build\"`. Env: `SENTRY_RELEASE` |\n| `dist` | `string` | — | Distribution identifier; max 64 chars. Env: `SENTRY_DIST` |\n| `sendDefaultPii` | `bool` | `false` | Include PII: IP address, user labels, widget text in replay |\n| `sampleRate` | `double` | `1.0` | Error event sampling (0.0–1.0) |\n| `maxBreadcrumbs` | `int` | `100` | Max breadcrumbs per event |\n| `attachStacktrace` | `bool` | `true` | Auto-attach stack traces to messages |\n| `attachScreenshot` | `bool` | `false` | Capture screenshot on error (mobile\u002Fdesktop only) |\n| `screenshotQuality` | enum | `high` | Screenshot quality: `full`, `high`, `medium`, `low` |\n| `attachViewHierarchy` | `bool` | `false` | Attach JSON widget tree as attachment on error |\n| `debug` | `bool` | `true` in debug | Verbose SDK output. **Never force `true` in production** |\n| `diagnosticLevel` | enum | `warning` | Log verbosity: `debug`, `info`, `warning`, `error`, `fatal` |\n| `enabled` | `bool` | `true` | Disable SDK entirely (e.g., for testing) |\n| `maxCacheItems` | `int` | `30` | Max offline-cached envelopes (not supported on Web) |\n| `sendClientReports` | `bool` | `true` | Send SDK health reports (dropped events, etc.) |\n| `reportPackages` | `bool` | `true` | Report `pubspec.yaml` dependency list |\n| `reportSilentFlutterErrors` | `bool` | `false` | Capture `FlutterErrorDetails.silent` errors |\n| `idleTimeout` | `Duration` | `3000ms` | Auto-finish idle user interaction transactions |\n\n### Tracing Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `tracesSampleRate` | `double` | — | Transaction sample rate (0–1). Enable by setting >0 |\n| `tracesSampler` | `function` | — | Per-transaction sampling; overrides `tracesSampleRate` |\n| `tracePropagationTargets` | `List` | — | URLs to attach `sentry-trace` + `baggage` headers |\n| `propagateTraceparent` | `bool` | `false` | Also send W3C `traceparent` header (SDK ≥9.7.0) |\n| `enableTimeToFullDisplayTracing` | `bool` | `false` | Opt-in TTFD tracking per screen |\n| `enableAutoPerformanceTracing` | `bool` | `true` | Auto-enable performance monitoring |\n| `enableUserInteractionTracing` | `bool` | `true` | Create transactions for tap\u002Fclick\u002Flong-press events |\n| `enableUserInteractionBreadcrumbs` | `bool` | `true` | Breadcrumbs for every tracked user interaction |\n\n### Profiling Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `profilesSampleRate` | `double` | — | Profiling rate relative to `tracesSampleRate`. **iOS\u002FmacOS only** |\n\n### Native \u002F Mobile Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `autoInitializeNativeSdk` | `bool` | `true` | Auto-initialize native Android\u002FiOS SDK layer |\n| `enableNativeCrashHandling` | `bool` | `true` | Capture native crashes (NDK, signal, Mach exception) |\n| `enableNdkScopeSync` | `bool` | `true` | Sync Dart scope to Android NDK |\n| `enableScopeSync` | `bool` | `true` | Sync scope data to native SDKs |\n| `anrEnabled` | `bool` | `true` | ANR detection (Android) |\n| `anrTimeoutInterval` | `int` | `5000` | ANR timeout in milliseconds (Android) |\n| `enableWatchdogTerminationTracking` | `bool` | `true` | OOM kill tracking (iOS) |\n| `enableTombstone` | `bool` | `false` | Android 12+ native crash info via `ApplicationExitInfo` |\n| `attachThreads` | `bool` | `false` | Attach all threads on crash (Android) |\n| `captureNativeFailedRequests` | `bool` | — | Native HTTP error capture, independent of Dart client (iOS\u002FmacOS, v9.11.0+) |\n| `enableAutoNativeAppStart` | `bool` | `true` | App start timing instrumentation (iOS\u002FAndroid) |\n| `enableFramesTracking` | `bool` | `true` | Slow\u002Ffrozen frame monitoring (iOS\u002FAndroid\u002FmacOS) |\n| `proguardUuid` | `string` | — | Proguard UUID for Android obfuscation mapping |\n\n### Session & Release Health Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `enableAutoSessionTracking` | `bool` | `true` | Session tracking for crash-free user\u002Fsession metrics |\n| `autoSessionTrackingInterval` | `Duration` | `30s` | Background inactivity before session ends |\n\n### Replay Options (`options.replay`)\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `replay.sessionSampleRate` | `double` | `0.0` | Fraction of all sessions recorded |\n| `replay.onErrorSampleRate` | `double` | `0.0` | Fraction of error sessions recorded |\n\n### Replay Privacy Options (`options.privacy`)\n\n| Option \u002F Method | Default | Purpose |\n|-----------------|---------|---------|\n| `privacy.maskAllText` | `true` | Mask all text widget content |\n| `privacy.maskAllImages` | `true` | Mask all image widgets |\n| `privacy.maskAssetImages` | `true` | Mask images from root asset bundle |\n| `privacy.mask\u003CT>()` | — | Mask a specific widget type and all subclasses |\n| `privacy.unmask\u003CT>()` | — | Unmask a specific widget type |\n| `privacy.maskCallback\u003CT>()` | — | Custom masking decision per widget instance |\n\n### HTTP Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `captureFailedRequests` | `bool` | `true` (Flutter) | Auto-capture HTTP errors |\n| `maxRequestBodySize` | enum | `never` | Body capture: `never`, `small`, `medium`, `always` |\n| `failedRequestStatusCodes` | `List` | `[500–599]` | Status codes treated as failures |\n| `failedRequestTargets` | `List` | `['.*']` | URL patterns to monitor |\n\n### Hook Options\n\n| Option | Type | Purpose |\n|--------|------|---------|\n| `beforeSend` | `(SentryEvent, Hint) → SentryEvent?` | Modify or drop error events. Return `null` to drop |\n| `beforeSendTransaction` | `(SentryEvent) → SentryEvent?` | Modify or drop transaction events |\n| `beforeBreadcrumb` | `(Breadcrumb, Hint) → Breadcrumb?` | Process breadcrumbs before storage |\n| `beforeSendLog` | `(SentryLog) → SentryLog?` | Filter structured logs before sending |\n\n### Environment Variables\n\nPass via `--dart-define` at build time:\n\n| Variable | Purpose | Notes |\n|----------|---------|-------|\n| `SENTRY_DSN` | Data Source Name | Falls back from `options.dsn` |\n| `SENTRY_ENVIRONMENT` | Deployment environment | Falls back from `options.environment` |\n| `SENTRY_RELEASE` | Release identifier | Falls back from `options.release` |\n| `SENTRY_DIST` | Build distribution | Falls back from `options.dist` |\n| `SENTRY_AUTH_TOKEN` | Upload debug symbols | **Never embed in app — build tool only** |\n| `SENTRY_ORG` | Organization slug | Used by `sentry_dart_plugin` |\n| `SENTRY_PROJECT` | Project slug | Used by `sentry_dart_plugin` |\n\nUsage:\n\n```bash\nflutter build apk --release \\\n  --dart-define=SENTRY_DSN=https:\u002F\u002Fxxx@sentry.io\u002F123 \\\n  --dart-define=SENTRY_ENVIRONMENT=production\n```\n\nThen in code:\n\n```dart\noptions.dsn = const String.fromEnvironment('SENTRY_DSN');\noptions.environment = const String.fromEnvironment('SENTRY_ENVIRONMENT', defaultValue: 'development');\n```\n\n### Production Settings\n\nLower sample rates and harden config before shipping:\n\n```dart\nFuture\u003Cvoid> main() async {\n  final isProduction = const bool.fromEnvironment('dart.vm.product');\n\n  await SentryFlutter.init(\n    (options) {\n      options.dsn = const String.fromEnvironment('SENTRY_DSN');\n      options.environment = isProduction ? 'production' : 'development';\n\n      \u002F\u002F Trace 10% of transactions in high-traffic production\n      options.tracesSampleRate = isProduction ? 0.1 : 1.0;\n\n      \u002F\u002F Profile 100% of traced transactions (profiling is always a subset)\n      options.profilesSampleRate = 1.0;\n\n      \u002F\u002F Replay all error sessions, sample 5% of normal sessions\n      options.replay.onErrorSampleRate = 1.0;\n      options.replay.sessionSampleRate = isProduction ? 0.05 : 1.0;\n\n      \u002F\u002F Disable debug logging in production\n      options.debug = !isProduction;\n    },\n    appRunner: () => runApp(SentryWidget(child: MyApp())),\n  );\n}\n```\n\n### Default Auto-Enabled Integrations\n\nThese are active with no extra config when you call `SentryFlutter.init()`:\n\n| Integration | What it does |\n|-------------|-------------|\n| `FlutterErrorIntegration` | Captures `FlutterError.onError` framework errors |\n| `RunZonedGuardedIntegration` | Catches unhandled Dart exceptions in runZonedGuarded |\n| `NativeAppStartIntegration` | App start timing (iOS\u002FAndroid) |\n| `FramesTrackingIntegration` | Slow\u002Ffrozen frames (iOS\u002FAndroid\u002FmacOS) |\n| `NativeUserInteractionIntegration` | User interaction breadcrumbs from native layer |\n| `UserInteractionIntegration` | Dart-layer tap\u002Fclick transactions (requires `SentryWidget`) |\n| `DeviceContextIntegration` | Device model, OS version, screen resolution |\n| `AppContextIntegration` | App version, build number, bundle ID |\n| `ConnectivityIntegration` | Network connectivity change breadcrumbs |\n| `HttpClientIntegration` | Auto-instrument Dart `http` requests |\n| `SdkIntegration` | SDK metadata tagging |\n| `ReleaseIntegration` | Auto-set release on iOS\u002FAndroid from package info |\n\n---\n\n## Verification\n\nAfter setup, test that Sentry is receiving events:\n\n```dart\n\u002F\u002F Add a test button somewhere visible during development:\nElevatedButton(\n  onPressed: () {\n    throw Exception('Sentry test error!');\n  },\n  child: const Text('Test Sentry Error'),\n)\n\n\u002F\u002F Or capture manually:\nElevatedButton(\n  onPressed: () {\n    Sentry.captureMessage('Sentry test message', level: SentryLevel.info);\n  },\n  child: const Text('Test Sentry Message'),\n)\n\n\u002F\u002F Test structured logging:\nElevatedButton(\n  onPressed: () {\n    Sentry.logger.info('Test log from Flutter app');\n  },\n  child: const Text('Test Sentry Log'),\n)\n```\n\n**Check the Sentry dashboard:**\n- **Issues** → test error should appear within seconds\n- **Traces** → look for a navigation transaction with child spans\n- **Replays** → session recording visible after app interaction (iOS\u002FAndroid only)\n- **Logs** → structured log entries if `enableLogs: true`\n\n> ⚠️ **Platform limitations in debug mode:**\n> - Native crashes, session replay, slow\u002Ffrozen frames, and app start metrics only fully work in release builds on iOS\u002FAndroid\n> - Run `flutter run --release` or use a real device\u002Femulator to test native features\n> - Debug mode uses the Dart VM with JIT compilation — some native integrations behave differently\n\n---\n\n## Phase 4: Cross-Link\n\nAfter completing Flutter setup, check for a backend missing Sentry coverage:\n\n```bash\n# Adjacent backend directories\nls ..\u002Fbackend ..\u002Fserver ..\u002Fapi 2>\u002Fdev\u002Fnull\ncat ..\u002Fgo.mod 2>\u002Fdev\u002Fnull | head -3\ncat ..\u002Frequirements.txt ..\u002Fpyproject.toml 2>\u002Fdev\u002Fnull | head -3\ncat ..\u002FGemfile 2>\u002Fdev\u002Fnull | head -3\nls ..\u002Fbackend\u002Fpackage.json ..\u002Fserver\u002Fpackage.json 2>\u002Fdev\u002Fnull\n```\n\nIf a backend exists without Sentry, suggest the matching skill:\n\n| Detected | Suggest skill |\n|----------|--------------|\n| Go backend (`go.mod`) | `sentry-go-sdk` |\n| Python backend (`requirements.txt`, `pyproject.toml`) | `sentry-python-sdk` |\n| Ruby backend (`Gemfile`) | `sentry-ruby-sdk` |\n| Node.js backend | `sentry-node-sdk` |\n| .NET backend (`*.csproj`) | `sentry-dotnet-sdk` |\n| React \u002F Next.js web | `sentry-react-sdk` \u002F `sentry-nextjs-sdk` |\n\n**Distributed tracing** — if a backend skill is added, configure `tracePropagationTargets` in Flutter to propagate trace context to your API:\n\n```dart\noptions.tracePropagationTargets = ['api.myapp.com', 'localhost'];\noptions.propagateTraceparent = true; \u002F\u002F also send W3C traceparent header\n```\n\nThis links mobile transactions to backend traces in the Sentry waterfall view.\n\n---\n\n## Troubleshooting\n\n| Issue | Solution |\n|-------|----------|\n| Events not appearing in Sentry | Set `options.debug = true` — SDK logs to Flutter console; verify DSN is correct |\n| `SentryFlutter.init` throws | Ensure `main()` is `async` and you `await SentryFlutter.init(...)` |\n| Stack traces unreadable in Sentry | Upload debug symbols with `sentry_dart_plugin`; build with `--obfuscate --split-debug-info` |\n| Stack traces missing on Web | Build with `--source-maps` and run `dart run sentry_dart_plugin` to upload |\n| Native crashes not captured | Confirm `enableNativeCrashHandling: true`; test in release mode, not debug |\n| Session replay not recording | iOS\u002FAndroid only; confirm `SentryWidget` wraps root; check `replay.onErrorSampleRate` |\n| Replay shows blank screens | Confirm `SentryWidget(child: MyApp())` is outermost widget; not inside navigator |\n| Profiling not working | iOS and macOS only (alpha); confirm `tracesSampleRate > 0` is set first |\n| Navigation not tracked | Add `SentryNavigatorObserver()` to `navigatorObservers`; name all routes |\n| GoRouter routes unnamed | Add `name:` to all `GoRoute` entries — unnamed routes are tracked as `null` |\n| TTFD never reports | Call `SentryFlutter.currentDisplay()?.reportFullyDisplayed()` after data loads, or wrap with `SentryDisplayWidget` |\n| `sentry_dart_plugin` auth error | Set `SENTRY_AUTH_TOKEN` env var instead of hardcoding in `pubspec.yaml` |\n| Android ProGuard mapping missing | Ensure `--extra-gen-snapshot-options=--save-obfuscation-map=...` flag is set |\n| iOS dSYM not uploaded | `sentry_dart_plugin` handles this; check `upload_debug_symbols: true` in `pubspec.yaml` `sentry:` block |\n| `pub get` fails: Dart SDK too old | `sentry_flutter` ≥9.0.0 requires Dart ≥3.5.0; run `flutter upgrade` |\n| Hot restart crashes on Android debug | Known issue (fixed in SDK ≥9.9.0); upgrade if on older version |\n| ANR detection too aggressive | Increase `anrTimeoutInterval` (default: 5000ms) |\n| Too many transactions in dashboard | Lower `tracesSampleRate` to `0.1` or use `tracesSampler` to drop health checks |\n| `beforeSend` not firing for native crashes | Expected — `beforeSend` intercepts only Dart-layer events; native crashes bypass it |\n| Crons not available | The Flutter\u002FDart SDK does not support Sentry Crons; use a server-side SDK instead |\n| `SentryWidget` warning in tests | Wrap test widget with `SentryFlutter.init()` in `setUpAll`, or use `enabled: false` |\n| Firebase Remote Config: Linux\u002FWindows | `sentry_firebase_remote_config` not supported on Linux\u002FWindows (Firebase limitation) |\n| Isar tracing on Web | `sentry_isar` does NOT support Web (Isar does not support Web) |\n",{"name":5,"parent":24,"license":15,"category":25,"description":7,"disable-model-invocation":26},"sentry-sdk-setup","sdk-setup",true,"main","b1e4ffadb4f933bbbcaa03a83f8b9929171ac28b",".agents\u002Fskills\u002Fsentry-flutter-sdk",0,"https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR","https:\u002F\u002Fgithub.com\u002FHazek-dc","2026-10-22 08:36:44",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":26},[36,39,42],{"tool":37,"command":38},"npx","npx skills add Hazek-dc\u002FPresensiGuru_FaceNet_EMAR --skill sentry-flutter-sdk",{"tool":40,"command":41},"bunx","bunx skills add Hazek-dc\u002FPresensiGuru_FaceNet_EMAR --skill sentry-flutter-sdk",{"tool":43,"command":44},"pnpm","pnpm dlx skills add Hazek-dc\u002FPresensiGuru_FaceNet_EMAR --skill sentry-flutter-sdk","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsentry-flutter-sdk\u002FSKILL.md",[47,53,57,61,65,69,73],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"references\u002Fecosystem-integrations.md","REFERENCE","参考文档",2763,"https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsentry-flutter-sdk\u002Freferences\u002Fecosystem-integrations.md",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"references\u002Ferror-monitoring.md",8571,"https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsentry-flutter-sdk\u002Freferences\u002Ferror-monitoring.md",{"path":58,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":59,"sourceHtmlUrl":60},"references\u002Flogging.md",12168,"https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsentry-flutter-sdk\u002Freferences\u002Flogging.md",{"path":62,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":63,"sourceHtmlUrl":64},"references\u002Fmetrics.md",9641,"https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsentry-flutter-sdk\u002Freferences\u002Fmetrics.md",{"path":66,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":67,"sourceHtmlUrl":68},"references\u002Fprofiling.md",8546,"https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsentry-flutter-sdk\u002Freferences\u002Fprofiling.md",{"path":70,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":71,"sourceHtmlUrl":72},"references\u002Fsession-replay.md",11465,"https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsentry-flutter-sdk\u002Freferences\u002Fsession-replay.md",{"path":74,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":75,"sourceHtmlUrl":76},"references\u002Ftracing.md",14271,"https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsentry-flutter-sdk\u002Freferences\u002Ftracing.md",[78,86,93,100,107,114],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":82,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M7DS6GGYRZAYD33PFPS8Z2T3","testing-best-practices","Laravel test design and review. Use when selecting coverage, naming or structuring tests, choosing assertions or test data, isolating dependencies, testing HTTP or security boundaries, improving suite performance, or reviewing test value. Use framework guidance or search-docs for Pest and PHPUnit syntax.","MIT","https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002Fattendance-web\u002F.claude\u002Fskills\u002Ftesting-best-practices\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":82,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M7DS6BC3AW7HTPRHE2TTVKWM","tailwindcss-development","Always invoke when the user's message includes 'tailwind' in any form. Also invoke for: building responsive grid layouts (multi-column card grids, product grids), flex\u002Fgrid page structures (dashboards with sidebars, fixed topbars, mobile-toggle navs), styling UI components (cards, tables, navbars, pricing sections, forms, inputs, badges), adding dark mode variants, fixing spacing or typography, and Tailwind v3\u002Fv4 work. The core use case: writing or fixing Tailwind utility classes in HTML templates (Blade, JSX, Vue). Skip for backend PHP logic, database queries, API routes, JavaScript with no HTML\u002FCSS component, CSS file audits, build tool configuration, and vanilla CSS.","https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002Fattendance-web\u002F.claude\u002Fskills\u002Ftailwindcss-development\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":82,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M7DS66GE6B11MYJDVC74HXM4","laravel-best-practices","Apply this skill whenever writing, reviewing, or refactoring Laravel PHP code. This includes creating or modifying controllers, models, migrations, form requests, policies, jobs, scheduled commands, service classes, and Eloquent queries. Triggers for N+1 and query performance issues, caching strategies, authorization and security patterns, validation, error handling, queue and job configuration, route definitions, and architectural decisions. Also use for Laravel code reviews and refactoring existing Laravel code to follow best practices. Covers any task involving Laravel backend PHP code patterns.","https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002Fattendance-web\u002F.claude\u002Fskills\u002Flaravel-best-practices\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":82,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":19},"01M7DS5ZW717DMS6P1E90AQCKV","infer-conventions","Use this skill to analyze how a Laravel application is actually written and record its conventions as shared rules. Trigger when the user wants to detect, infer, document, or standardize project conventions or coding style, set up or grow `.ai\u002Frules`, resolve mixed or conflicting patterns (e.g. \"are we using Form Requests or inline validation?\"), or onboard agents and teammates to \"how we do things here\". Covers: a systematic sweep of ~49 Laravel convention dimensions (validation, models, architecture, testing, frontend, database, console), open-ended house-pattern discovery, conflict reporting, and recording rules scoped to the right paths via the Boost `record-rule` MCP tool. Only run this skill when the user explicitly asks for it; never start a sweep as part of another task. Do not use for one-off code review, enforcing formatting a linter already handles, or editing `.ai\u002Frules` files by hand.","https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002Fattendance-web\u002F.claude\u002Fskills\u002Finfer-conventions\u002FSKILL.md",[],[],{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":82,"licenseFileUrl":6,"sourceHtmlUrl":111,"categories":112,"keywords":113,"publishedAt":19},"01M7DS5W12RGCVJTFQJ1N0GB8E","inertia-react-development","Develops Inertia.js v2 React client-side applications. Activates when creating React pages, forms, or navigation; using \u003CLink>, \u003CForm>, useForm, or router; working with deferred props, prefetching, or polling; or when user mentions React with Inertia, React pages, React forms, or React navigation.","https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002Fattendance-web\u002F.claude\u002Fskills\u002Finertia-react-development\u002FSKILL.md",[],[],{"skillNo":115,"name":116,"nameZh":6,"description":117,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":82,"licenseFileUrl":6,"sourceHtmlUrl":118,"categories":119,"keywords":120,"publishedAt":19},"01M7DS5PVDPMPCWSK2RXPDC9BB","deploying-to-cloud","Deploys and manages Laravel applications on Laravel Cloud using the `cloud` CLI. Use when the user wants to deploy an app, ship to Cloud, create or manage applications, environments, databases, caches, object storage, queues, domains, instances, background processes, secrets, compute, scheduled tasks, or Laravel Cloud infrastructure; or check billing, usage, or spend. Triggers on deployment, shipping, Cloud management, environment setup, database provisioning, billing or usage queries, the `cloud` CLI, and Laravel Cloud deployment troubleshooting.","https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002Fattendance-web\u002F.claude\u002Fskills\u002Fdeploying-to-cloud\u002FSKILL.md",[],[]]