---
title: "Stack Trace"
description: "Inspect an error and expand its stack frames."
---

# Stack Trace

Inspect an error and expand its stack frames.

## Usage

Expand the failed command and inspect application and framework stack frames. Replay repeats the sample failure.

## Example

```contract
use uiFontFamily, BubbleFrame from "@rightui/ui"
use ButtonAI as ButtonContent from "@rightui/ui"
use TraceFrame, TraceLine, TraceCollapsible, TraceDisclosure, TraceSource, CodeBlockContent from "@rightui/ui"

component Demo
  props
    width: number
    reduced: bool
  inject
    uiFont: string
    rightuiDemoTime: number
    rightuiRunDemo: action
  state started = -1
  derive elapsed = started < 0 ? 12100 : max(0, rightuiDemoTime - started)
  derive busy = elapsed < 2100
  action replay
    started = rightuiDemoTime
    rightuiRunDemo(6100)
  view
    column gap="ui.space-16" min-width=0 min-height=288 max-width="24rem" width="100%" padding="ui.space-24 ui.space-0"
      BubbleFrame(id="ai-stack-trace-question", align="end", variant="muted")
        text "Reset the database and seed it." font-family=uiFontFamily(uiFont) data-rightui-font="body"
      TraceFrame()
        TraceCollapsible(id="ai-stack-trace-0", title=((elapsed < 900 ? "Running " : "Ran ") + "pnpm prisma migrate reset --skip-seed"), icon="terminal", status=(elapsed < 900 ? "running" : ""), initiallyOpen=false, reduced=reduced)
          if elapsed >= 900
            CodeBlockContent(id="ai-stack-reset", code="Database reset successful\n\nThe following migrations have been applied:\n\nmigrations/\n  \u2514\u2500 20260912_init/\n  \u2514\u2500 20260920_add_profiles/")
        if elapsed >= 900
          if elapsed < 2100
            TraceLine(title="Running pnpm prisma db seed", icon="terminal", status="running", reduced=reduced)
          else
            TraceCollapsible(id="ai-stack-trace-1", title="Failed: TypeError: Cannot read properties of undefined (reading 'email')", icon="terminal", status="error", initiallyOpen=true, reduced=reduced)
              text "TypeError: Cannot read properties of undefined (reading 'email')" font-family="ui.font-code" font-size="ui.text-xs" color="ui.danger"
              TraceSource(title="seedUsers in prisma/seed.ts:27", href="#prisma/seed.ts:27", reduced=reduced)
              TraceSource(title="main in prisma/seed.ts:51", href="#prisma/seed.ts:51", reduced=reduced)
              TraceCollapsible(id="ai-stack-framework", title="4 framework frames", icon="layers", status="", initiallyOpen=false, reduced=reduced)
                CodeBlockContent(id="ai-stack-frames", code="at Module._compile (node:internal/modules/cjs/loader:1554:14)\nat Object.transformer (node_modules/tsx/dist/register.cjs:3:1104)\nat Module.load (node:internal/modules/cjs/loader:1289:32)\nat process.processTicksAndRejections (node:internal/process/task_queues:105:5)")
      if elapsed >= 2100
        text "The migrations ran, but the seed failed in seedUsers. One fixture has no profile, so profile.email is undefined.".slice(0, started < 0 or reduced ? 112 : floor((elapsed - 2100) / 20)) font-size="ui.text-sm" line-height="ui.leading-relaxed" font-family=uiFontFamily(uiFont) data-rightui-font="body"
      if not busy
        row margin-top="auto" align-items="flex-start"
          ButtonContent(id="ai-stack-trace-replay", label="Replay", variant="outline", size="sm", disabled=false, press=replay)
            text "Replay" font-family=uiFontFamily(uiFont) data-rightui-font="body"

```

## Keyboard

Tab to actions and disclosures; Enter or Space activates them.

## Demo runtime

Timed examples use an injected clock. Add these members to your root component. Replace the scripted state with events from your TypeScript or Rust data source when connecting a model.

```contract
use defaultFontWeights from "@rightui/ui"
  state demoTime = 0
  state demoUntil = 0
  provide
    uiFont = "theme"
    uiWeights = defaultFontWeights()
    rightuiDemoTime = demoTime
    rightuiRunDemo = runDemo
  action runDemo(duration: number)
    demoUntil = max(demoUntil, demoTime + duration)
  action tickDemo
    demoTime = min(demoUntil, demoTime + 32)
  task demoClock when demoTime < demoUntil
    every(32, tickDemo)
```

## Source

File: patterns/ai-elements/stack-trace.contract

```contract
use uiFontFamily, BubbleFrame from "@rightui/ui"
use ButtonAI as ButtonContent from "@rightui/ui"
use TraceFrame, TraceLine, TraceCollapsible, TraceDisclosure, TraceSource, CodeBlockContent from "@rightui/ui"

component Demo
  props
    width: number
    reduced: bool
  inject
    uiFont: string
    rightuiDemoTime: number
    rightuiRunDemo: action
  state started = -1
  derive elapsed = started < 0 ? 12100 : max(0, rightuiDemoTime - started)
  derive busy = elapsed < 2100
  action replay
    started = rightuiDemoTime
    rightuiRunDemo(6100)
  view
    column gap="ui.space-16" min-width=0 min-height=288 max-width="24rem" width="100%" padding="ui.space-24 ui.space-0"
      BubbleFrame(id="ai-stack-trace-question", align="end", variant="muted")
        text "Reset the database and seed it." font-family=uiFontFamily(uiFont) data-rightui-font="body"
      TraceFrame()
        TraceCollapsible(id="ai-stack-trace-0", title=((elapsed < 900 ? "Running " : "Ran ") + "pnpm prisma migrate reset --skip-seed"), icon="terminal", status=(elapsed < 900 ? "running" : ""), initiallyOpen=false, reduced=reduced)
          if elapsed >= 900
            CodeBlockContent(id="ai-stack-reset", code="Database reset successful\n\nThe following migrations have been applied:\n\nmigrations/\n  \u2514\u2500 20260912_init/\n  \u2514\u2500 20260920_add_profiles/")
        if elapsed >= 900
          if elapsed < 2100
            TraceLine(title="Running pnpm prisma db seed", icon="terminal", status="running", reduced=reduced)
          else
            TraceCollapsible(id="ai-stack-trace-1", title="Failed: TypeError: Cannot read properties of undefined (reading 'email')", icon="terminal", status="error", initiallyOpen=true, reduced=reduced)
              text "TypeError: Cannot read properties of undefined (reading 'email')" font-family="ui.font-code" font-size="ui.text-xs" color="ui.danger"
              TraceSource(title="seedUsers in prisma/seed.ts:27", href="#prisma/seed.ts:27", reduced=reduced)
              TraceSource(title="main in prisma/seed.ts:51", href="#prisma/seed.ts:51", reduced=reduced)
              TraceCollapsible(id="ai-stack-framework", title="4 framework frames", icon="layers", status="", initiallyOpen=false, reduced=reduced)
                CodeBlockContent(id="ai-stack-frames", code="at Module._compile (node:internal/modules/cjs/loader:1554:14)\nat Object.transformer (node_modules/tsx/dist/register.cjs:3:1104)\nat Module.load (node:internal/modules/cjs/loader:1289:32)\nat process.processTicksAndRejections (node:internal/process/task_queues:105:5)")
      if elapsed >= 2100
        text "The migrations ran, but the seed failed in seedUsers. One fixture has no profile, so profile.email is undefined.".slice(0, started < 0 or reduced ? 112 : floor((elapsed - 2100) / 20)) font-size="ui.text-sm" line-height="ui.leading-relaxed" font-family=uiFontFamily(uiFont) data-rightui-font="body"
      if not busy
        row margin-top="auto" align-items="flex-start"
          ButtonContent(id="ai-stack-trace-replay", label="Replay", variant="outline", size="sm", disabled=false, press=replay)
            text "Replay" font-family=uiFontFamily(uiFont) data-rightui-font="body"

```
