33 lines
2.3 KiB
Markdown
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.
|