diff --git a/README.md b/README.md index b79c0aa8d460..6dce62c864a4 100644 --- a/README.md +++ b/README.md @@ -104,6 +104,8 @@ As [DB UX Design System](https://marketingportal.extranet.deutschebahn.com/marke We're providing a detailed migration for each component next to the documentation of each component, like e.g. +For a comprehensive overview of all DB-UI components and their migration status, including components that don't have direct equivalents in DB-UX Design System v3, see our [DB-UI to DB-UX Design System v3 Component Migration Guide](https://github.com/db-ux-design-system/core-web/blob/main/docs/migration/db-ui-to-db-ux-dsv3.md). + ### In between DB UX Design System Core versions Check our migration docs for breaking changes: diff --git a/docs/migration/db-ui-to-db-ux-dsv3.md b/docs/migration/db-ui-to-db-ux-dsv3.md new file mode 100644 index 000000000000..2ea43e1cb43c --- /dev/null +++ b/docs/migration/db-ui-to-db-ux-dsv3.md @@ -0,0 +1,163 @@ +# DB-UI to DB-UX Design System v3 Component Migration Guide + +> **Note** +> This document provides migration guidance for DB-UI components that don't have direct equivalents in DB-UX Design System v3. For package name changes and general migration information, see [v0.7.x-to-v1.0.0.md](./v0.7.x-to-v1.0.0.md). + +## Overview + +DB-UX Design System v3 represents a complete rethinking of the component architecture with a focus on atomic design principles, accessibility, and modern web standards. Some DB-UI components have been redesigned, consolidated, or are planned for future releases. + +## Components without Direct Equivalents + +| Component | Status | Recommendation | Description | +| --------------------------- | :----: | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `rea-main` | ❌ | Use `db-page` with custom layout | The `db-page` component provides basic page structure. It already includes `
` | +| `rea-grid` | ❌ | Use CSS Grid or `db-stack` component | Replace with modern CSS Grid for complex layouts, or use `db-stack` for simple spacing. See [CSS Grid examples](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Grid_Layout) | +| `rea-footer` | 🔄 | Under research - build custom for now ,Planned for Q4/2025 | Footer component is being researched. Use semantic `