# How a completed design system migration reduced inconsistency across a multi-stack codebase

DevFeed: [How a completed design system migration reduced inconsistency across a multi-stack codebase](<https://devfeed.tech/articles/no-more-tech-debt-89385.md>)

Original publisher: [Read original article](<https://swizec.com/blog/no-more-tech-debt>)

Author: hi@swizec.com (Swizec Teller)

Published: 2026-10-17T00:00:00Z

Content type: article

Language: en

Sources: [Swizec Teller](<https://devfeed.tech/sources/swizec-teller.md>)

Topics: [Design system](<https://devfeed.tech/topics/design-system.md>), [Primer](<https://devfeed.tech/topics/primer.md>), [User interface design](<https://devfeed.tech/topics/ui-design.md>), [AI Context Switching](<https://devfeed.tech/topics/ai-context-switching.md>), [Legacy Modernization](<https://devfeed.tech/topics/legacy-modernization.md>)

Tags: [ai](<https://devfeed.tech/tags/ai.md>), [claude](<https://devfeed.tech/tags/claude.md>), [code](<https://devfeed.tech/tags/code.md>), [design-system](<https://devfeed.tech/tags/design-system.md>), [htmx](<https://devfeed.tech/tags/htmx.md>), [tech-debt](<https://devfeed.tech/tags/tech-debt.md>)

## AI overview

The author describes completing a design system migration across React, HTMX, and Jinja pages. The team first established shared components, migration guidance, and linters, then moved pages in vertical slices with visual comparisons. The work replaced an unsupported component library and reduced the number of files importing JoyUI from 592 to 146 in a week.

## Source excerpt

For the first time in my career we _completed_ a design system migration. The new math on big rewrites tickles my soul.