feat(logs): Add dart/flutter logs empty state (#98196)

resolves
https://linear.app/getsentry/issue/LOGS-316/add-empty-state-onboarding-for-flutterdart-sdks

<img width="1206" height="786" alt="image"
src="https://github.com/user-attachments/assets/35719080-dbee-4439-82c1-1ec2cf0f03b9"
/>

Author: AbhiPrasad

static/app/data/platformCategories.tsx

@@ -307,6 +307,8 @@ export const withoutPerformanceSupport: Set<PlatformKey> = new Set([
 // List of platforms that have logging onboarding checklist content
 export const withLoggingOnboarding: Set<PlatformKey> = new Set([
   'android',
+  'dart',
+  'flutter',
   'go',
   'go-echo',
   'go-fasthttp',

static/app/gettingStartedDocs/dart/dart.tsx

@@ -249,10 +249,103 @@ Sentry.captureUserFeedback(userFeedback);`,
   nextSteps: () => [],
 };
 
+const logsOnboarding: OnboardingConfig = {
+  install: params => [
+    {
+      type: StepType.INSTALL,
+      content: [
+        {
+          type: 'text',
+          text: tct(
+            'Logs for Dart are supported in SDK version [code:9.0.0] or higher. You can update your [pubspec:pubspec.yaml] to the matching version:',
+            {
+              code: <code />,
+              pubspec: <code />,
+            }
+          ),
+        },
+        {
+          type: 'code',
+          tabs: [
+            {
+              label: 'YAML',
+              language: 'yaml',
+              code: getInstallSnippet(params),
+            },
+          ],
+        },
+        {
+          type: 'text',
+          text: tct(
+            'If you are on an older major version of the SDK, follow our [link:migration guide] to upgrade.',
+            {
+              link: (
+                <ExternalLink href="https://docs.sentry.io/platforms/dart/migration/" />
+              ),
+            }
+          ),
+        },
+      ],
+    },
+  ],
+  configure: params => [
+    {
+      type: StepType.CONFIGURE,
+      content: [
+        {
+          type: 'text',
+          text: tct(
+            'To enable logging, you need to initialize the SDK with the [code:enableLogs] option set to [code:true].',
+            {
+              code: <code />,
+            }
+          ),
+        },
+        {
+          type: 'code',
+          language: 'dart',
+          code: `await Sentry.init(
+  (options) {
+    options.dsn = '${params.dsn.public}';
+    // Enable logs to be sent to Sentry
+    options.enableLogs = true;
+  },
+);`,
+        },
+      ],
+    },
+  ],
+  verify: () => [
+    {
+      type: StepType.VERIFY,
+      content: [
+        {
+          type: 'text',
+          text: t(
+            'You can verify that logs are working by sending logs with the Sentry logger APIs.'
+          ),
+        },
+        {
+          type: 'code',
+          language: 'dart',
+          code: `Sentry.logger.fmt.info("Test log from %s", ["Sentry"])`,
+        },
+        {
+          type: 'text',
+          text: tct('For more details, check out our [link:logs documentation].', {
+            link: <ExternalLink href="https://docs.sentry.io/platforms/dart/logs/" />,
+          }),
+        },
+      ],
+    },
+  ],
+};
+
 const docs: Docs = {
   onboarding,
   feedbackOnboardingCrashApi: feedbackOnboardingCrashApiDart,
   crashReportOnboarding: feedbackOnboardingCrashApiDart,
+  logsOnboarding,
 };
 
 export default docs;

static/app/gettingStartedDocs/flutter/flutter.tsx

@@ -539,12 +539,107 @@ const feedbackOnboarding: OnboardingConfig<PlatformOptions> = {
   nextSteps: () => [],
 };
 
+const logsOnboarding: OnboardingConfig<PlatformOptions> = {
+  install: params => [
+    {
+      type: StepType.INSTALL,
+      content: [
+        {
+          type: 'text',
+          text: tct(
+            'Logs for Flutter are supported in SDK version [code:9.0.0] or higher. You can update your [pubspec:pubspec.yaml] to the matching version:',
+            {
+              code: <code />,
+              pubspec: <code />,
+            }
+          ),
+        },
+        {
+          type: 'code',
+          tabs: [
+            {
+              label: 'YAML',
+              language: 'yaml',
+              code: getManualInstallSnippet(params),
+            },
+          ],
+        },
+        {
+          type: 'text',
+          text: tct(
+            'If you are on an older major version of the SDK, follow our [link:migration guide] to upgrade.',
+            {
+              link: (
+                <ExternalLink href="https://docs.sentry.io/platforms/dart/guides/flutter/migration/" />
+              ),
+            }
+          ),
+        },
+      ],
+    },
+  ],
+  configure: params => [
+    {
+      type: StepType.CONFIGURE,
+      content: [
+        {
+          type: 'text',
+          text: tct(
+            'To enable logging, you need to initialize the SDK with the [code:enableLogs] option set to [code:true].',
+            {
+              code: <code />,
+            }
+          ),
+        },
+        {
+          type: 'code',
+          language: 'dart',
+          code: `await SentryFlutter.init(
+  (options) {
+    options.dsn = '${params.dsn.public}';
+    // Enable logs to be sent to Sentry
+    options.enableLogs = true;
+  },
+);`,
+        },
+      ],
+    },
+  ],
+  verify: () => [
+    {
+      type: StepType.VERIFY,
+      content: [
+        {
+          type: 'text',
+          text: t(
+            'You can verify that logs are working by sending logs with the Sentry logger APIs.'
+          ),
+        },
+        {
+          type: 'code',
+          language: 'dart',
+          code: `Sentry.logger.fmt.info("Test log from %s", ["Sentry"])`,
+        },
+        {
+          type: 'text',
+          text: tct('For more details, check out our [link:logs documentation].', {
+            link: (
+              <ExternalLink href="https://docs.sentry.io/platforms/dart/guides/flutter/logs/" />
+            ),
+          }),
+        },
+      ],
+    },
+  ],
+};
+
 const docs: Docs<PlatformOptions> = {
   onboarding,
   feedbackOnboardingNpm: feedbackOnboarding,
   crashReportOnboarding: feedbackOnboardingCrashApiDart,
   platformOptions,
   replayOnboarding,
+  logsOnboarding,
 };
 
 export default docs;