https://github.com/yworks/migrate-yfiles-app
JavaScript toolchain that helps in migrating applications written for older yFiles for HTML versions to newer ones
https://github.com/yworks/migrate-yfiles-app
yfiles
Last synced: 3 months ago
JSON representation
JavaScript toolchain that helps in migrating applications written for older yFiles for HTML versions to newer ones
- Host: GitHub
- URL: https://github.com/yworks/migrate-yfiles-app
- Owner: yWorks
- License: mit
- Created: 2016-11-09T16:45:59.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2025-04-02T10:03:00.000Z (6 months ago)
- Last Synced: 2025-06-05T22:08:32.568Z (4 months ago)
- Topics: yfiles
- Language: TypeScript
- Homepage:
- Size: 2.37 MB
- Stars: 4
- Watchers: 12
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# yFiles Migration Tool
[](https://www.npmjs.org/package/@yworks/migrate-yfiles-app)
The source of this tool is available at [GitHub](https://github.com/yWorks/migrate-yfiles-app).
Use this tool to help you migrate your existing yFiles application a new version.
The migration-tool will work best on strict typescript. For frontend frameworks,
it is best to keep the script-code separate from HTML-templates.
> [!CAUTION]
>In order for the migration tool to work, you to have the version of yFiles for HTML installed into your project that you want to migrate from. That is, when migrating from 2.6 to 3.0, 2.6 needs to be installed.
In general the tool will either perform automatic migration or add a migration
comment that can include helpful information to ease more complex migration
operations.
As shown the automatic migrations range in complexity from simple renames to more complex signature changes.
> [!CAUTION]
> This tool will manipulate the files in place, make sure that you have no uncommitted changes and/or a backup
> [!IMPORTANT]
> This version is exclusively for the migration from 2.6 to 3.0, for earlier version have a look at earlier GitHub releases
## Usage
Point the migration-tool to the tsconfig of your project
```
npx @yworks/migrate-yfiles-app@latest --configPath=
```
or alternatively to a folder containing the files you want to migrate
```
npx @yworks/migrate-yfiles-app@latest --folderPath=
```
When migrating from e.g. 3.0-EAP1 use the
```
--from="EAP1"
```
flag.
To enable the migration of Vue components use the
```
---vue
```
flag.
## About yFiles
[yFiles](https://www.yworks.com/yfiles) is the industry-leading software library for visualizing, editing and analyzing graphs.
## Contact
[yWorks.com/contact](https://www.yworks.com/contact)
yWorks GmbH, Vor dem Kreuzberg 28, 72070 Tuebingen, Germany