# Showcase and media

pi-jar's README visual should demonstrate the real TUI rather than a polished mockup that quietly invents capabilities. The canonical demo asset is:

```text
docs/assets/pi-jar-demo.gif
```

## What the demo should show

The primary loop should make the product understandable without narration:

- the animated torch-style `π` and natural flame/ember motion;
- the hopeful welcome message and live workspace card;
- visible project, session, plan, goal, task and role state when available;
- the composer and Ember mascot so the welcome screen feels connected to the working UI.

## Capture guidelines

Keep the source capture in a dark terminal using a pi-jar theme. Crop dead time before the UI appears, avoid showing secrets or unrelated desktop chrome, and prefer a short loop over a full recording. The README version should be optimized for quick loading; the original recording can remain outside the repository.

The visual is supporting evidence, not the documentation itself. Every demonstrated feature should still be explained in the README or the focused docs.