Skip to content

The only tool you need to know what is happening and how to fix it.

flutter support added

ddux47812842d87f
diff --git a/backend/app/controllers/auth.controller.go b/backend/app/controllers/auth.controller.go
index 0a2241f7..2f89f5f4 100644
--- a/backend/app/controllers/auth.controller.go
+++ b/backend/app/controllers/auth.controller.go
@@ -154,7 +154,7 @@ func (a authController) Register(c *gin.Context) {
if !validFrameworks[request.Framework] {
traceway.CaptureMessage("Invalid framework received during registration: " + request.Framework)
- c.JSON(http.StatusBadRequest, gin.H{"error": "Framework must be one of: gin, fiber, chi, fasthttp, stdlib, custom, react, svelte, vuejs, jquery, hono, cloudflare, opentelemetry, symfony"})
+ c.JSON(http.StatusBadRequest, gin.H{"error": "Framework must be one of: gin, fiber, chi, fasthttp, stdlib, custom, react, svelte, vuejs, jquery, hono, cloudflare, opentelemetry, symfony, flutter"})
return
}
diff --git a/backend/app/controllers/project.controller.go b/backend/app/controllers/project.controller.go
index 30b130aa..7f4f132d 100644
--- a/backend/app/controllers/project.controller.go
+++ b/backend/app/controllers/project.controller.go
@@ -39,6 +39,8 @@ var validFrameworks = map[string]bool{
"opentelemetry": true,
// PHP frameworks
"symfony": true,
+ // Mobile frameworks
+ "flutter": true,
}
// Project name validation regex: allows alphanumeric, spaces, hyphens, and underscores
@@ -86,7 +88,7 @@ func (p projectController) CreateProject(c *gin.Context) {
if !validFrameworks[request.Framework] {
traceway.CaptureMessage("Invalid framework received: " + request.Framework)
- c.JSON(http.StatusBadRequest, gin.H{"error": "Framework must be one of: gin, fiber, chi, fasthttp, stdlib, custom, react, svelte, vuejs, jquery, hono, cloudflare, opentelemetry, symfony"})
+ c.JSON(http.StatusBadRequest, gin.H{"error": "Framework must be one of: gin, fiber, chi, fasthttp, stdlib, custom, react, svelte, vuejs, jquery, hono, cloudflare, opentelemetry, symfony, flutter"})
return
}
diff --git a/docs/pages/client/_meta.json b/docs/pages/client/_meta.json
index 6127589c..a984ecb9 100644
--- a/docs/pages/client/_meta.json
+++ b/docs/pages/client/_meta.json
@@ -23,5 +23,6 @@
"openrouter": "OpenRouter",
"otel": "OpenTelemetry",
"cloudflare": "Cloudflare Workers",
- "symfony": "Symfony"
+ "symfony": "Symfony",
+ "flutter": "Flutter"
}
diff --git a/docs/pages/client/flutter/_meta.json b/docs/pages/client/flutter/_meta.json
new file mode 100644
index 00000000..8393d864
--- /dev/null
+++ b/docs/pages/client/flutter/_meta.json
@@ -0,0 +1,3 @@
+{
+ "index": "Quick Start"
+}
diff --git a/docs/pages/client/flutter/index.mdx b/docs/pages/client/flutter/index.mdx
new file mode 100644
index 00000000..4bdcb039
--- /dev/null
+++ b/docs/pages/client/flutter/index.mdx
@@ -0,0 +1,116 @@
+# Flutter Quick Start
+
+Integrate Traceway into your Flutter application with the `traceway` package from pub.dev.
+
+## Installation
+
+```bash
+flutter pub add traceway
+```
+
+## Setup
+
+Use `Traceway.run()` to wrap your app. This initializes the SDK and captures errors automatically:
+
+```dart
+import 'package:flutter/material.dart';
+import 'package:traceway/traceway.dart';
+
+void main() {
+ Traceway.run(
+ connectionString: 'your-token@https://traceway.example.com/api/report',
+ options: TracewayOptions(
+ screenCapture: true,
+ version: '1.0.0',
+ ),
+ child: MyApp(),
+ );
+}
+```
+
+## Capture Errors Manually
+
+```dart
+import 'package:traceway/traceway.dart';
+
+// Capture a caught exception
+try {
+ await riskyOperation();
+} catch (e, st) {
+ TracewayClient.instance?.captureException(e, st);
+}
+
+// Capture a message
+TracewayClient.instance?.captureMessage('User completed onboarding');
+```
+
+## With Options
+
+`TracewayOptions` accepts the following parameters:
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `sampleRate` | `double` | `1.0` | Event sampling rate (0.0 to 1.0) |
+| `screenCapture` | `bool` | `false` | Records the last ~10 seconds of screen as video |
+| `debug` | `bool` | `false` | Prints debug info to the console |
+| `version` | `String` | `''` | App version string |
+| `debounceMs` | `int` | `1500` | Milliseconds before sending batched events |
+| `capturePixelRatio` | `double` | `0.5` | Screenshot resolution scale |
+
+```dart
+Traceway.run(
+ connectionString: 'your-token@https://traceway.example.com/api/report',
+ options: TracewayOptions(
+ sampleRate: 0.5,
+ screenCapture: true,
+ debug: true,
+ version: '2.1.0',
+ debounceMs: 2000,
+ capturePixelRatio: 0.75,
+ ),
+ child: MyApp(),
+);
+```
+
+## Screen Recording
+
+When `screenCapture` is set to `true`:
+
+- The SDK wraps the app in a `RepaintBoundary` and captures frames at approximately 15 fps.
+- On exception, the last ~10 seconds are encoded to MP4 and sent alongside the error report.
+- Touch and click positions are rendered as red circles on the captured frames. These overlays are invisible to the user during normal use.
+- Recordings appear in the Traceway dashboard alongside the stack trace, giving you full visual context for every error.
+
+## What Gets Captured Automatically
+
+`Traceway.run()` sets up capture for the following error sources with no additional configuration:
+
+- **Flutter framework errors** — rendering, layout, and gesture errors reported through `FlutterError.onError`.
+- **Platform errors** — native platform channel errors.
+- **Uncaught async errors** — any unhandled exceptions in asynchronous code, captured via Dart's `Zone` mechanism.
+
+## Test Your Integration
+
+Add a button that throws an error to verify everything is wired up:
+
+```dart
+ElevatedButton(
+ onPressed: () {
+ throw StateError('Test error from Traceway');
+ },
+ child: Text('Send Test Error'),
+)
+```
+
+Tap the button and check your Traceway dashboard to verify the error appears.
+
+## Platform Support
+
+| Platform | Error Tracking | Screen Recording |
+|----------|---------------|-----------------|
+| iOS | Yes | Yes |
+| Android | Yes | Yes |
+| macOS | Yes | Yes |
+| Web | No | No |
+
+Flutter web apps should use the [JS SDK](/client/js-sdk) instead.
diff --git a/examples/devtesting-embedded/frontend/package-lock.json b/examples/devtesting-embedded/frontend/package-lock.json
index 579d4890..4577b48a 100644
--- a/examples/devtesting-embedded/frontend/package-lock.json
+++ b/examples/devtesting-embedded/frontend/package-lock.json
@@ -14,9 +14,9 @@
},
"../../../../js-client/packages/jquery": {
"name": "@tracewayapp/jquery",
- "version": "1.0.3",
+ "version": "1.0.4",
"dependencies": {
- "@tracewayapp/frontend": "1.0.3"
+ "@tracewayapp/frontend": "1.0.4"
}
},
"node_modules/@esbuild/aix-ppc64": {
diff --git a/frontend/src/lib/components/framework-combobox.svelte b/frontend/src/lib/components/framework-combobox.svelte
index 74d340c5..bc4df051 100644
--- a/frontend/src/lib/components/framework-combobox.svelte
+++ b/frontend/src/lib/components/framework-combobox.svelte
@@ -35,6 +35,7 @@
{ value: 'hono', label: 'Hono', description: 'Lightweight multi-runtime framework (OTLP)', group: 'Backend' },
{ value: 'cloudflare', label: 'Cloudflare', description: 'Cloudflare Workers (OTLP Traces)', group: 'Backend' },
{ value: 'opentelemetry', label: 'OpenTelemetry', description: 'Vendor-neutral observability', group: 'Backend' },
+ { value: 'flutter', label: 'Flutter', description: 'Mobile UI framework', group: 'Mobile' },
] as const;
const selectedFrameworkLabel = $derived(getFrameworkLabel(value));
@@ -55,6 +56,7 @@
const jsFrameworks = $derived(filteredFrameworks.filter(f => f.group === 'JavaScript'));
const phpFrameworks = $derived(filteredFrameworks.filter(f => f.group === 'PHP'));
const backendFrameworks = $derived(filteredFrameworks.filter(f => f.group === 'Backend'));
+ const mobileFrameworks = $derived(filteredFrameworks.filter(f => f.group === 'Mobile'));
function handleOpenChange(isOpen: boolean) {
open = isOpen;
@@ -224,6 +226,32 @@
{/each}
</Combobox.Group>
{/if}
+ {#if mobileFrameworks.length > 0}
+ <Combobox.Group>
+ <Combobox.GroupHeading class="px-2 py-1.5 text-xs font-semibold text-muted-foreground">Mobile</Combobox.GroupHeading>
+ {#each mobileFrameworks as fw}
+ <Combobox.Item
+ value={fw.value}
+ class={cn(
+ "data-[highlighted]:bg-accent data-[highlighted]:text-accent-foreground [&_svg:not([class*='text-'])]:text-muted-foreground relative flex w-full cursor-default items-center gap-2 rounded-sm py-1.5 ps-2 pe-8 text-sm outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4"
+ )}
+ >
+ {#snippet children({ selected })}
+ <div class="flex items-center gap-2">
+ <FrameworkIcon framework={fw.value} />
+ <div class="flex flex-col">
+ <span class="font-medium">{fw.label}</span>
+ <span class="text-xs text-muted-foreground">{fw.description}</span>
+ </div>
+ </div>
+ {#if selected}
+ <Check class="absolute end-2 size-4" />
+ {/if}
+ {/snippet}
+ </Combobox.Item>
+ {/each}
+ </Combobox.Group>
+ {/if}
{/if}
</Combobox.Viewport>
<SelectScrollDownButton />
diff --git a/frontend/src/lib/components/framework-icon.svelte b/frontend/src/lib/components/framework-icon.svelte
index ba687d3b..c95dad54 100644
--- a/frontend/src/lib/components/framework-icon.svelte
+++ b/frontend/src/lib/components/framework-icon.svelte
@@ -56,6 +56,8 @@
<img src="/opentelemetry.png" alt="OpenTelemetry" class={className} />
{:else if framework === 'symfony'}
<img src="/symfony.png" alt="Symfony" class={className} />
+{:else if framework === 'flutter'}
+ <img src="/flutter.png" alt="Flutter" class={className} style="object-fit: contain;" />
{:else}
<img src="/custom.png" alt="Custom" class={className} />
{/if}
diff --git a/frontend/src/lib/components/issues/session-replay.svelte b/frontend/src/lib/components/issues/session-replay.svelte
index 4e379dd5..11f1ef2f 100644
--- a/frontend/src/lib/components/issues/session-replay.svelte
+++ b/frontend/src/lib/components/issues/session-replay.svelte
@@ -1,10 +1,18 @@
<script lang="ts">
import { onMount, onDestroy } from 'svelte';
- import { Globe } from 'lucide-svelte';
+ import { Globe, Play, Pause, Maximize, Minimize } from 'lucide-svelte';
import type { eventWithTime } from '@rrweb/types';
+ interface FlutterVideoEvent {
+ type: 'flutter_video';
+ data: string;
+ format: string;
+ fps: number;
+ durationSeconds: number;
+ }
+
interface Props {
- events: (eventWithTime & { data?: { href?: string } })[] | null;
+ events: (eventWithTime & { data?: { href?: string } })[] | FlutterVideoEvent[] | null;
}
let { events }: Props = $props();
@@ -12,8 +20,121 @@
let player: any = null;
let resizeObserver: ResizeObserver | null = null;
+ let isFlutterVideo = $derived(
+ events && events.length > 0 && (events[0] as any)?.type === 'flutter_video'
+ );
+
+ let flutterVideoSrc = $derived.by(() => {
+ if (!isFlutterVideo || !events) return '';
+ const evt = events[0] as unknown as FlutterVideoEvent;
+ return `data:video/mp4;base64,${evt.data}`;
+ });
+
+ let videoEl: HTMLVideoElement;
+ let videoContainerEl: HTMLElement;
+ let playing = $state(false);
+ let currentTime = $state(0);
+ let duration = $state(0);
+ let playbackSpeed = $state(1);
+ let isFullscreen = $state(false);
+ let dragging = $state(false);
+ let progressPercent = $derived(duration > 0 ? (currentTime / duration) * 100 : 0);
+
+ function formatTime(seconds: number): string {
+ const m = Math.floor(seconds / 60);
+ const s = Math.floor(seconds % 60);
+ return `${String(m).padStart(2, '0')}:${String(s).padStart(2, '0')}`;
+ }
+
+ function togglePlay() {
+ if (!videoEl) return;
+ if (videoEl.paused) {
+ videoEl.play();
+ } else {
+ videoEl.pause();
+ }
+ }
+
+ function setSpeed(speed: number) {
+ playbackSpeed = speed;
+ if (videoEl) videoEl.playbackRate = speed;
+ }
+
+ function toggleFullscreen() {
+ if (!videoContainerEl) return;
+ if (document.fullscreenElement) {
+ document.exitFullscreen();
+ } else {
+ videoContainerEl.requestFullscreen();
+ }
+ }
+
+ function handleProgressClick(e: MouseEvent) {
+ if (!videoEl || !duration) return;
+ const target = e.currentTarget as HTMLElement;
+ const rect = target.getBoundingClientRect();
+ const ratio = Math.max(0, Math.min(1, (e.clientX - rect.left) / rect.width));
+ videoEl.currentTime = ratio * duration;
+ }
+
+ function handleProgressDragStart(e: MouseEvent) {
+ e.preventDefault();
+ dragging = true;
+ const progressEl = (e.currentTarget as HTMLElement).parentElement!;
+
+ const onMove = (ev: MouseEvent) => {
+ const rect = progressEl.getBoundingClientRect();
+ const ratio = Math.max(0, Math.min(1, (ev.clientX - rect.left) / rect.width));
+ currentTime = ratio * duration;
+ if (videoEl) videoEl.currentTime = currentTime;
+ };
+
+ const onUp = () => {
+ dragging = false;
+ window.removeEventListener('mousemove', onMove);
+ window.removeEventListener('mouseup', onUp);
+ };
+
+ window.addEventListener('mousemove', onMove);
+ window.addEventListener('mouseup', onUp);
+ }
+
+ $effect(() => {
+ if (!videoEl) return;
+
+ const onTimeUpdate = () => {
+ if (!dragging) currentTime = videoEl.currentTime;
+ };
+ const onLoadedMetadata = () => {
+ duration = videoEl.duration;
+ };
+ const onPlay = () => {
+ playing = true;
+ };
+ const onPause = () => {
+ playing = false;
+ };
+ const onFullscreenChange = () => {
+ isFullscreen = !!document.fullscreenElement;
+ };
+
+ videoEl.addEventListener('timeupdate', onTimeUpdate);
+ videoEl.addEventListener('loadedmetadata', onLoadedMetadata);
+ videoEl.addEventListener('play', onPlay);
+ videoEl.addEventListener('pause', onPause);
+ document.addEventListener('fullscreenchange', onFullscreenChange);
+
+ return () => {
+ videoEl.removeEventListener('timeupdate', onTimeUpdate);
+ videoEl.removeEventListener('loadedmetadata', onLoadedMetadata);
+ videoEl.removeEventListener('play', onPlay);
+ videoEl.removeEventListener('pause', onPause);
+ document.removeEventListener('fullscreenchange', onFullscreenChange);
+ };
+ });
+
let pageUrl = $derived.by(() => {
- if (!events || events.length === 0) return '';
+ if (!events || events.length === 0 || isFlutterVideo) return '';
const metaEvent = events.find((e: any) => e.type === 4);
return metaEvent?.data?.href ?? '';
});
@@ -23,7 +144,7 @@
}
onMount(async () => {
- if (!events || events.length === 0) return;
+ if (!events || events.length === 0 || isFlutterVideo) return;
const { default: rrwebPlayer } = await import('rrweb-player');
await import('rrweb-player/dist/style.css');
@@ -65,13 +186,83 @@
{#if events && events.length > 0}
<div class="player-wrapper overflow-hidden">
- {#if pageUrl}
+ {#if isFlutterVideo}
<div class="url-bar">
- <Globe />
- <span class="url-bar-text">{pageUrl}</span>
+ <img src="/flutter.png" alt="Flutter" class="flutter-icon" />
+ <span class="url-bar-text">Flutter Screen Recording</span>
+ </div>
+ <div class="flutter-video-container" bind:this={videoContainerEl}>
+ <video
+ bind:this={videoEl}
+ src={flutterVideoSrc}
+ playsinline
+ loop
+ onclick={togglePlay}
+ >
+ <track kind="captions" />
+ </video>
+ <div class="fv-controller">
+ <div class="fv-timeline">
+ <span class="fv-timeline__time">{formatTime(currentTime)}</span>
+ <!-- svelte-ignore a11y_no_static_element_interactions -->
+ <div
+ class="fv-progress"
+ role="slider"
+ tabindex="0"
+ aria-valuemin={0}
+ aria-valuemax={duration}
+ aria-valuenow={currentTime}
+ onclick={handleProgressClick}
+ onkeydown={(e) => {
+ if (!videoEl) return;
+ if (e.key === 'ArrowRight') videoEl.currentTime = Math.min(duration, currentTime + 5);
+ if (e.key === 'ArrowLeft') videoEl.currentTime = Math.max(0, currentTime - 5);
+ }}
+ >
+ <div class="fv-progress__step" style:width="{progressPercent}%"></div>
+ <div
+ class="fv-progress__handler"
+ style:left="{progressPercent}%"
+ onmousedown={handleProgressDragStart}
+ ></div>
+ </div>
+ <span class="fv-timeline__time">{formatTime(duration)}</span>
+ </div>
+ <div class="fv-controller__btns">
+ <button onclick={togglePlay}>
+ {#if playing}
+ <Pause size={16} />
+ {:else}
+ <Play size={16} />
+ {/if}
+ </button>
+ {#each [1, 2, 4, 8] as s}
+ <button
+ class:active={playbackSpeed === s}
+ onclick={() => setSpeed(s)}
+ >
+ {s}x
+ </button>
+ {/each}
+ <button onclick={toggleFullscreen}>
+ {#if isFullscreen}
+ <Minimize size={16} />
+ {:else}
+ <Maximize size={16} />
+ {/if}
+ </button>
+ </div>
+ </div>
</div>
+ {:else}
+ {#if pageUrl}
+ <div class="url-bar">
+ <Globe />
+ <span class="url-bar-text">{pageUrl}</span>
+ </div>
+ {/if}
+ <div bind:this={container} class="player-container"></div>
{/if}
- <div bind:this={container} class="player-container"></div>
</div>
{/if}
@@ -92,6 +283,12 @@
flex-shrink: 0;
}
+ .flutter-icon {
+ width: 14px;
+ height: 14px;
+ flex-shrink: 0;
+ }
+
.url-bar-text {
font-family: ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, monospace;
font-size: 12px;
@@ -201,4 +398,140 @@
.player-wrapper :global(.replayer-mouse) {
background-image: url('data:image/svg+xml;charset=utf-8;base64,PHN2ZyB4bWxucz0naHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmcnIHdpZHRoPSczMDBweCcgaGVpZ2h0PSczMDBweCcgdmlld0JveD0nMCAwIDUwIDUwJz48cGF0aCBkPSdNNSAyTDUgNDNMMTQuNSAzM0wyMyA0OEwzMCA0NC41TDIxLjUgMjkuNUwzNSAyOS41WicgZmlsbD0nIzAwMDAwMCcgc3Ryb2tlPScjZmZmZmZmJyBzdHJva2Utd2lkdGg9JzIuNScgc3Ryb2tlLWxpbmVqb2luPSdyb3VuZCcvPjwvc3ZnPg==') !important;
}
+
+ /* Flutter video player */
+ .flutter-video-container {
+ display: flex;
+ flex-direction: column;
+ align-items: center;
+ background: var(--muted);
+ min-height: 300px;
+ }
+
+ .flutter-video-container video {
+ max-width: 100%;
+ max-height: 70vh;
+ background: #000;
+ cursor: pointer;
+ flex: 1;
+ }
+
+ .flutter-video-container:fullscreen {
+ background: #000;
+ justify-content: center;
+ }
+
+ .flutter-video-container:fullscreen video {
+ max-height: calc(100vh - 80px);
+ }
+
+ .flutter-video-container:fullscreen .fv-controller {
+ position: absolute;
+ bottom: 0;
+ left: 0;
+ right: 0;
+ opacity: 0;
+ transition: opacity 0.2s;
+ }
+
+ .flutter-video-container:fullscreen:hover .fv-controller {
+ opacity: 1;
+ }
+
+ .fv-controller {
+ width: 100%;
+ background: var(--muted);
+ border-top: 1px solid var(--border);
+ border-radius: 0px 0px 9px 9px;
+ display: flex;
+ flex-direction: column;
+ justify-content: space-around;
+ align-items: center;
+ padding: 8px 0;
+ }
+
+ .fv-timeline {
+ width: 80%;
+ display: flex;
+ align-items: center;
+ padding: 8px 0;
+ }
+
+ .fv-timeline__time {
+ display: inline-block;
+ width: 80px;
+ text-align: center;
+ font-family: ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, monospace;
+ font-size: 12px;
+ color: var(--muted-foreground);
+ }
+
+ .fv-progress {
+ flex: 1;
+ height: 6px;
+ background: var(--border);
+ position: relative;
+ border-radius: 3px;
+ cursor: pointer;
+ }
+
+ .fv-progress__step {
+ height: 100%;
+ position: absolute;
+ left: 0;
+ top: 0;
+ background: var(--chart-1);
+ border-radius: 3px;
+ }
+
+ .fv-progress__handler {
+ width: 14px;
+ height: 14px;
+ background: var(--chart-1);
+ border-radius: 50%;
+ position: absolute;
+ top: 50%;
+ transform: translate(-50%, -50%);
+ cursor: grab;
+ }
+
+ .fv-progress__handler:active {
+ cursor: grabbing;
+ }
+
+ .fv-controller__btns {
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ font-size: 13px;
+ gap: 2px;
+ }
+
+ .fv-controller__btns button {
+ width: 32px;
+ height: 32px;
+ display: flex;
+ padding: 0;
+ align-items: center;
+ justify-content: center;
+ background: none;
+ border: none;
+ border-radius: 50%;
+ cursor: pointer;
+ color: var(--foreground);
+ }
+
+ .fv-controller__btns button:hover {
+ background: var(--accent);
+ }
+
+ .fv-controller__btns button.active {
+ background: var(--chart-1);
+ color: #fff;
+ }
+
+ .fv-controller__btns button:active {
+ background: var(--chart-1);
+ opacity: 0.8;
+ }
</style>
diff --git a/frontend/src/lib/state/projects.svelte.ts b/frontend/src/lib/state/projects.svelte.ts
index 2dd8e283..3e8ff997 100644
--- a/frontend/src/lib/state/projects.svelte.ts
+++ b/frontend/src/lib/state/projects.svelte.ts
@@ -1,9 +1,9 @@
import { api } from '$lib/api';
import { authState } from './auth.svelte';
-export type Framework = 'gin' | 'fiber' | 'chi' | 'fasthttp' | 'stdlib' | 'custom' | 'react' | 'svelte' | 'vuejs' | 'nextjs' | 'nestjs' | 'express' | 'remix' | 'jquery' | 'hono' | 'cloudflare' | 'opentelemetry' | 'symfony';
+export type Framework = 'gin' | 'fiber' | 'chi' | 'fasthttp' | 'stdlib' | 'custom' | 'react' | 'svelte' | 'vuejs' | 'nextjs' | 'nestjs' | 'express' | 'remix' | 'jquery' | 'hono' | 'cloudflare' | 'opentelemetry' | 'symfony' | 'flutter';
-export const FRONTEND_FRAMEWORKS: Framework[] = ['react', 'svelte', 'vuejs', 'jquery'];
+export const FRONTEND_FRAMEWORKS: Framework[] = ['react', 'svelte', 'vuejs', 'jquery', 'flutter'];
export const JS_FRAMEWORKS: Framework[] = ['react', 'svelte', 'vuejs', 'nextjs', 'nestjs', 'express', 'remix', 'jquery'];
export const FRAMEWORK_LABELS: Record<Framework, string> = {
@@ -25,12 +25,19 @@ export const FRAMEWORK_LABELS: Record<Framework, string> = {
cloudflare: 'Cloudflare',
opentelemetry: 'OpenTelemetry',
symfony: 'Symfony',
+ flutter: 'Flutter',
};
+export const MOBILE_FRAMEWORKS: Framework[] = ['flutter'];
+
export function getFrameworkLabel(fw: Framework): string {
return FRAMEWORK_LABELS[fw] ?? fw;
}
+export function isMobileFramework(fw: Framework): boolean {
+ return MOBILE_FRAMEWORKS.includes(fw);
+}
+
export function isFrontendFramework(fw: Framework): boolean {
return FRONTEND_FRAMEWORKS.includes(fw);
}
diff --git a/frontend/src/lib/utils/framework-code.ts b/frontend/src/lib/utils/framework-code.ts
index 2341f93d..53fee1b1 100644
--- a/frontend/src/lib/utils/framework-code.ts
+++ b/frontend/src/lib/utils/framework-code.ts
@@ -38,6 +38,8 @@ export function getInstallCommand(framework: Framework): string {
return '';
case 'opentelemetry':
return '';
+ case 'flutter':
+ return 'flutter pub add traceway';
case 'custom':
default:
return base;
@@ -284,6 +286,21 @@ $kernel->terminate($request, $response);`;
case 'opentelemetry':
return '';
+ case 'flutter':
+ return `import 'package:flutter/material.dart';
+import 'package:traceway/traceway.dart';
+
+void main() {
+ Traceway.run(
+ connectionString: '${connectionString}',
+ options: TracewayOptions(
+ screenCapture: true,
+ version: '1.0.0',
+ ),
+ child: MyApp(),
+ );
+}`;
+
case 'custom':
default:
return `package main
@@ -319,6 +336,10 @@ class TestController
throw new \\RuntimeException("Test error from Traceway integration");
}
}`;
+ }
+ if (framework === 'flutter') {
+ return `// Trigger a test error
+throw StateError('Test error from Traceway integration');`;
}
if (framework && isJsFramework(framework)) {
return `// Trigger a test error
@@ -333,6 +354,14 @@ export function getTestingRouteCode2(framework?: Framework): string {
if (framework === 'symfony') {
return '';
}
+ if (framework === 'flutter') {
+ return `import 'package:traceway/traceway.dart';
+
+TracewayClient.instance?.captureException(
+ Exception('Test error'),
+ StackTrace.current,
+);`;
+ }
if (framework && isJsFramework(framework)) {
switch (framework) {
case 'react':
@@ -400,6 +429,7 @@ export function getFrameworkLabel(framework: Framework): string {
cloudflare: 'Cloudflare',
opentelemetry: 'OpenTelemetry',
symfony: 'Symfony',
+ flutter: 'Flutter',
};
return labels[framework] || framework;
}
@@ -409,5 +439,6 @@ export function getCodeLanguage(framework: Framework): 'go' | 'javascript' | 'ba
if (framework === 'opentelemetry') return 'go';
if (framework === 'hono') return 'javascript';
if (framework === 'cloudflare') return 'javascript';
+ if (framework === 'flutter') return 'javascript'; // closest to Dart syntax highlighting
return isJsFramework(framework) ? 'javascript' : 'go';
}
diff --git a/frontend/static/flutter.png b/frontend/static/flutter.png
new file mode 100644
index 00000000..f1b32df8
Binary files /dev/null and b/frontend/static/flutter.png differ