Files
streamline/.tt-impeccable.md
2026-11-16 17:26:44 -08:00

33 lines
2.3 KiB
Markdown

## TUX Design Context
### Product Surface
Streamline is a desktop-first internal operations dashboard for coordinating and reviewing automated TikTok engineering work. The login gate is the entry point to the authenticated board.
### Users
TikTok engineers and operators use the dashboard at work to monitor queues, review evidence, and act on engineering tasks.
### Fidelity Intent
TT Style web application, with a restrained, neutral product-tool hierarchy rather than a mobile TikTok screen.
### Theme
Light and dark themes are supported. The login card intentionally presents the supplied black-on-white Streamline wordmark treatment in both themes.
### Glassmorphism
Adopted deliberately (user decision, following the "social insights" reference): one frosted band covers the top bar (filter pills, 创建) and the row of column titles — one layer only. Columns scroll as a whole from the top of the window so cards pass *under* that band and tint it as they go; column titles stay pinned inside the band, transparent, with no frosted pane of their own (a second pane read as a double layer and was rejected). Honour `prefers-reduced-transparency` (solid fallbacks are in the same CSS block). Do not remove this; do not spread it to cards or panels.
The left sidebar is the one other deliberate exception (user decision, 2026-11): it is a frosted, translucent panel over the workspace backdrop (sky blue at the top settling into white, soft `#BAF4FF` patches, fine white grain — all painted once on `.workspace`), so the backdrop shows through it. Solid fallback under `prefers-reduced-transparency`. Still not on cards or other panels.
### Repository Posture
React + Vite with a global CSS token layer and local components. `@byted-tiktok/tux-web` is not installed. Extend existing components before adding new primitives.
### Design Principles
- Keep the work itself visually dominant and application chrome quiet.
- Use neutral surfaces and reserve color for state and action.
- Reuse existing components and semantic tokens before adding new styles.
- Preserve keyboard, reduced-motion, and responsive behavior.
### Pre-existing Violations
- The global stylesheet contains numerous raw hex/rgba values rather than `--tux-*` tokens.
- Several text styles use non-zero letter spacing and off-scale sizes/weights.
- Some hover states change border color.