Skip to content

TEDI Design System Migration Guide

Airike Jaska edited this page Nov 6, 2025 · 5 revisions

This guide helps you migrate from the old @tehik-ee/tedi-* packages to the new @tedi-design-system/* packages.


Package Mapping

Old Package New Package URL for Package Repository Storybook
@tehik-ee/tedi-core @tedi-design-system/core https://www.npmjs.com/package/@tedi-design-system/core https://github.com/TEDI-Design-System/core -
@tehik-ee/tedi-react @tedi-design-system/react https://www.npmjs.com/package/@tedi-design-system/react https://github.com/TEDI-Design-System/react https://storybook.tedi.ee/react
@tehik-ee/tedi-angular @tedi-design-system/angular https://www.npmjs.com/package/@tedi-design-system/angular https://github.com/TEDI-Design-System/angular https://storybook.tedi.ee/angular

General Migration Steps

  1. Remove old packages and install new ones
  2. Replace import paths throughout your codebase
  3. Check for API or styling differences
  4. Run builds, tests, and linters
  5. Clean up dependencies and verify functionality

1. Migrate Core Library (if you use standalone core library)

From: @tehik-ee/tedi-core
To: @tedi-design-system/core

1. Update dependencies

npm uninstall @tehik-ee/tedi-core
npm install @tedi-design-system/core

2. Update imports

- import from '@tehik-ee/tedi-core';
+ import from '@tedi-design-system/core';

2. Migrate React Library

From: @tehik-ee/tedi-react
To: @tedi-design-system/react

1. Update dependencies

npm uninstall @tehik-ee/tedi-react
npm install @tedi-design-system/react

2. Update imports

- import { Button, Link } from '@tehik-ee/tedi-react/tedi';
+ import { Button, Link } from '@tedi-design-system/react/tedi';

or if you use community components:

- import { Modal } from '@tehik-ee/tedi-react/community';
+ import { Modal } from '@tedi-design-system/react/community';

3. Migrate Angular Library

From: @tehik-ee/tedi-angular
To: @tedi-design-system/angular

1. Update dependencies

npm uninstall @tehik-ee/tedi-angular
npm install @tedi-design-system/angular

2. Update imports

- import { ButtonComponent } from '@tehik-ee/tedi-angular/tedi';
+ import { ButtonComponent } from '@tedi-design-system/angular/tedi';

or if you use community components:

- import { FileDropzone } from '@tehik-ee/tedi-angular/community';
+ import { FileDropzone } from '@tedi-design-system/angular/community';

Run checks:

ng lint
ng build

Final Cleanup

After completing all migrations:

rm -rf node_modules package-lock.json
npm install

Ensure everything builds, tests, and linting pass successfully.


Summary

Task Description
Replace Imports Update all @tehik-ee/tedi-* imports
Update Packages Install new @tedi-design-system/* versions
Verify APIs Adjust for renamed props, modules, and tokens
Clean & Test Rebuild, lint, and test your application

You’re done!
Your project should now be using the new @tedi-design-system packages.

Clone this wiki locally