# Pill Corner Radius

## Essence

Pill Corner Radius is the approved token for intentionally pill-shaped controls.

## Token

- `--radius-pill`

## Value

- `999px`

## Visual Role

Creates a fully rounded horizontal control shape where the component should read as a pill rather than a normal rounded rectangle.

## Use When

- Rendering `Header Home Button`.
- Rendering `Floating Button`.
- A component contract explicitly calls for pill geometry.

## Do Not Use When

- A compact control should use normal rounded corners.
- A card, tile, preview, or surface needs a contained shape.
- The shape is circular; circles should be intrinsic to the component dimensions.

## Rules

- Use this token instead of local `999px`.
- Do not use this token as a substitute for missing large corner-radius scale.
- Keep pill use intentional and rare.

## Code Paths

- `packages/design-system/src/styles/tokens.css`
- `packages/design-system/src/components/HeaderHomeButton.astro`
- `packages/design-system/src/components/FloatingButton.astro`