Video annotations and interactions

Video annotations and interactions

Annotation rules

• Use at most two lines per annotation.
• Keep each annotation focused on one idea.
• Display standard annotations for 4 to 5 seconds.
• Do not cover the button or badge being explained.
• Do not repeat text already visible in the interface.

Visual style

Element	Recommendation
Title	2 to 4 words, semi-bold
Description	One short user-facing sentence
Background	Dark neutral surface with light opacity
Text	White with strong contrast
Accent	Product accent for outline or target marker
Motion	Short fade in and fade out
Pointer	Thin ring around the target for important clicks

Mouse interactions

Interaction	Video treatment	Use
Hover	Visible cursor and short pause	Badges, tooltips, disabled reasons
Single click	Brief ring at click point	Buttons, tabs, cards, menus
Double click	Two quick rings	File or folder opening when relevant
Typing	Visible focus and readable typing pace	Search, filters, paths
Menu opening	Hover then click	Command palette, profile, native menu
File selection	Mock field or native picker	Workspace root, import folder
Modal validation	Pause before click, then result	Create, simulate, save
Destructive cancel	Open confirmation, then cancel	Remove, delete archive, clear logs

High-priority callouts

• Pending synchronization.
• Workspace root path.
• Project workflow status.
• EXIF coverage.
• Archive checksum.
• Integrity mismatch.
• Restore simulation.
• Offline and local-first behavior.

Avoid

• Do not annotate every click.
• Do not cover badges while explaining them.
• Do not confirm destructive actions during capture.
• Do not show secrets, tokens, real buckets, or personal email addresses.
• Do not speed up important typing until it becomes unreadable.