Media guide

March 13, 2026 ยท View on GitHub

This file tracks the screenshots and GIFs that should be added.

Use the placeholders in README.md and docs/*.md as insertion points.

Suggested fileTypeWhere it belongsWhat it should show
hero-overview.gifGIFREADME.mdOpen a file, insert a log, save, open dashboard, open help modal
dashboard-overview.pngScreenshotREADME.mdEntire dashboard with header, list, footer, preview
dashboard-help-modal.pngScreenshotREADME.md, docs/DASHBOARD.mdThe help modal open over the dashboard
first-log.pngScreenshotdocs/GETTING_STARTED.mdSimple TS file with one inserted RocketLog
getting-started.gifGIFdocs/GETTING_STARTED.mdFirst-run workflow from insert to dashboard help
motion-logging.gifGIFdocs/USAGE.mdMotion-based insertion examples
stale-entry.pngScreenshotdocs/USAGE.mdDashboard entry marked stale
dashboard-anatomy.pngScreenshotdocs/DASHBOARD.mdAnnotated or clearly framed dashboard panes
dashboard-comment-toggle.gifGIFdocs/DASHBOARD.mdToggle one log with c, then whole file with C

Capture tips

General

  • use a clean colorscheme with strong contrast
  • keep the font readable
  • crop tightly around the relevant UI
  • avoid giant empty margins
  • hide unrelated plugins if they clutter the shot

GIFs

  • keep them short, around 6โ€“12 seconds
  • do one workflow per GIF
  • make sure key presses are clear from the resulting UI changes

Screenshots

  • prefer real plugin output over mockups
  • include enough surrounding code to give context
  • for dashboard shots, include at least:
    • one file group,
    • one selected log,
    • preview pane content,
    • footer cheatsheet content.

Use relative paths like:

![RocketLog dashboard overview](./docs/assets/dashboard-overview.png)

or from inside docs:

![RocketLog getting started](./assets/getting-started.gif)