---
name: google-material3
description: NarmaForge Tonal Foundation: dynamic HCT extraction, 5-tier surface containers, shape scale, and motion.
---

# NarmaForge Tonal Expressive Foundation

Build expressive, adaptive interfaces following the NarmaForge Tonal sovereign design foundation.

## 1. Core Principles
- **Tonal Surfaces over Shadows**: Depth is communicated primarily through tinted surface container tiers rather than heavy drop shadows.
- **Dynamic Adaptivity**: Palette generates automatically from a brand seed color in the HCT (Hue, Chroma, Tone) space.
- **Expressive Shapes**: Systematic shape scale from subtle pills to organic rounded containers.

## 2. Foundation Specifications
- [Tonal Palettes and Roles](references/tonal-palettes.md): HCT extraction, Primary, Secondary, Tertiary, Error, and Outline tokens for light and dark schemes.
- [Surface Containers and Motion](references/surface-and-motion.md): Five-tier container hierarchy (`surfaceContainerLowest` through `surfaceContainerHighest`), shape scale, and emphasized motion curves.

## 3. Implementation Checklist
- Select root surface and map card elements to `surfaceContainer` or `surfaceContainerLow`.
- Use contrasting text with corresponding `on-*` color roles (e.g. `onPrimary` on `primary`).
- Apply emphasized easing curve `cubic-bezier(0.2, 0.0, 0, 1.0)` for animated transitions.