Phoenix Design

Name: Phoenix Design
Author: Arize-ai

ASecurity

Design system conventions for the Phoenix frontend — layout, dialogs, error display, BEM CSS class naming, and CSS design tokens. Use when building UI, naming CSS classes, creating or consuming tokens, handling errors, or designing dialog interactions in js/app/src/.

11,740 stars
0 votes
0 copies
2 views
Added September 1, 2026

ai-agentsapifrontend

Works with

Security analysis

A100/100

Pro scans all 9 files and shows the line behind each finding

Scanned September 29, 2026

npx -y skills add Arize-ai/phoenix --skill phoenix-design --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Phoenix Design?

Add the live security badge to your README. It updates with every re-scan.

[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/arize-ai-phoenix-design/badge)](https://www.skillsdirectory.com/skills/arize-ai-phoenix-design)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro

SKILL.md

---
name: phoenix-design
description: Design system conventions for the Phoenix frontend — layout, dialogs, error display, BEM CSS class naming, and CSS design tokens. Use when building UI, naming CSS classes, creating or consuming tokens, handling errors, or designing dialog interactions in js/app/src/.
license: Apache-2.0
metadata:
  author: oss@arize.com
  version: "2.0.0"
  internal: true
---

# Phoenix Design System

The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this specification are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.

## What Are You Doing?

Read the relevant reference(s) based on the task:

| Task | Reference |
|------|-----------|
| Layout stability, scroll behavior, interaction patterns, tooltip placement in tables | `references/layout.md` |
| Alert and form dialog usage, footer button styling, content writing | `references/dialogs.md` |
| Error scoping, inline alerts, input validation | `references/error-display.md` |
| Naming CSS classes | `references/bem.md` |
| Creating or consuming CSS design tokens | `references/tokens.md` |
| Picking an icon for a noun (project, trace, span, file, etc.) | `references/icons.md` |
| Displaying counts in tabs, headings, or filter buttons | `references/counters.md` |
| Choosing or adding an `EmptyStateGraphic` variant (the per-region/topic empty-state graphics) | `references/empty-states.md` |
| Writing or reviewing Storybook stories for design-system components | the `phoenix-storybook` skill |