# Migration from qt-material-widgets

This document tracks migration from the older architecture.

Key changes:
- typed Material 3 theme roles
- layered architecture
- spec-driven rendering
- canonical Material 3 widget names
- legacy alias bridge only as a transition tool