> ## Documentation Index
> Fetch the complete documentation index at: https://docs.littledemo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

Fix common LittleDemo setup, generation, embed, and auth issues.

## The CLI says I am not signed in

Run:

```bash
littledemo whoami
```

If that fails, sign in again:

```bash
littledemo login
```

For CI, set:

```bash
export LITTLEDEMO_API_KEY=ld_live_xxx
```

## Dynamic embed returns unauthorized

Check that you are using a publishable key:

```text
ld_pub_...
```

Then confirm the current domain is in the key's allowed-domain list.

## The demo records the wrong section

Use a template and section hint:

```bash
littledemo demos create \
  --project proj_abc123 \
  --prompt "Feature the security section" \
  --template section-focus \
  --section "security"
```

## The player is too small

Use a responsive 16:9 wrapper instead of a fixed height.

```html
<div style="position:relative;width:100%;aspect-ratio:16/9">
  <iframe
    src="https://littledemo.com/embed/demo_abc123"
    style="position:absolute;inset:0;width:100%;height:100%;border:0"
  ></iframe>
</div>
```

## Refresh did not update the embed

Check the demo status:

```bash
curl https://littledemo.com/api/v1/demos/demo_abc123 \
  -H "Authorization: Bearer ld_live_xxx"
```

The embed serves the latest ready version. If the refresh job failed, the previous ready version remains available.