From aadf0867f450b4f1db5c19931b16381e5bded4a6 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Sun, 31 Aug 2025 15:13:47 +0000 Subject: [PATCH 1/3] Initial plan From 819b100e6fb1be39aee12e64abc68b0043d1fb78 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Sun, 31 Aug 2025 15:25:31 +0000 Subject: [PATCH 2/3] Add comprehensive DB-UI to DB-UX-DSv3 component migration guide Co-authored-by: mfranzke <787658+mfranzke@users.noreply.github.com> --- README.md | 2 + docs/migration/db-ui-to-db-ux-dsv3.md | 167 ++++++++++++++++++++++++++ docs/migration/v0.7.x-to-v1.0.0.md | 4 + 3 files changed, 173 insertions(+) create mode 100644 docs/migration/db-ui-to-db-ux-dsv3.md diff --git a/README.md b/README.md index b657d71a4894..a3e330f469be 100644 --- a/README.md +++ b/README.md @@ -88,6 +88,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..82ffc203e634 --- /dev/null +++ b/docs/migration/db-ui-to-db-ux-dsv3.md @@ -0,0 +1,167 @@ +# 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. Implement main content area using semantic HTML `
` with custom CSS grid/flexbox | +| `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 | Footer component is being researched. Use semantic `