# terminal-window
Chrome wrapper with traffic lights, path, and labeled progress bar.
──
examples
projects/main malayvasa/folder
|context13.27%
──
install
npx shadcn@latest add "https://www.terminal-kit.com/r/terminal-window.json"
──
component api
TerminalWindow
Top-level shell with header chrome, scroll body, and optional footer.
PropTypeDefaultDescription
pathstringPath label in the header.
progressnumber | { value, label?, showValue? } | falseundefinedHeader progress bar. Pass false to hide.
showTrafficLightsbooleantrueShow macOS-style traffic lights in the header.
theme"default" | "grok" | "claude""default"Built-in palette. Default is a neutral dark terminal; grok is warm dark; claude matches the Claude Code product page terminal mockup.
variant"dark" | "light""dark"Light palette override via theme-specific classes (e.g. .terminal-theme-grok-light). Site light mode (html:not(.dark)) also switches the active theme to its light tokens.
footerReactNodePinned footer slot — usually Input.
headerReactNodeOptional header slot above scroll content.
fillbooleanfalseStretch to fill a fixed-height window and scroll internally.
pinScrollBottombooleanfalsePin scroll content to the bottom as new lines appear.
bodyClassNamestringClasses for the inner body layout wrapper.
headerActionReactNodeOptional control rendered at the end of the window chrome header.
classNamestringAdditional CSS classes on the window shell.
...propsHTMLDivElementStandard div props.
advanced
TerminalBody
Deprecated — pass footer, header, fill, and pinScrollBottom to TerminalWindow instead.
PropTypeDefaultDescription
footerReactNodePinned footer slot — usually Input.
headerReactNodeOptional header slot above scroll content.
pinScrollBottombooleanfalsePin scroll content to the bottom as new lines appear.
fillbooleanfalseStretch to fill a fixed-height window and scroll internally.