See how easy it is to move from Backstage to Phaset. Paste your Backstage catalog YAML below or upload files to instantly convert them to Phaset format. Don't have files at hand? Use the demo data!
Need to convert multiple Backstage files at once? Use Phaset's package phaset-from-backstage to automate the conversion process. Perfect for migrating entire catalogs with hundreds of entities.
npm install phaset-from-backstageThe package provides both a CLI tool and a JavaScript API for converting Backstage YAML files to Phaset format. Visit the GitHub repository for full documentation and examples.
Here's how Backstage fields map to Phaset:
| Backstage | Phaset | Notes |
|---|---|---|
metadata.name | spec.name | Direct mapping |
metadata.description | spec.description | Falls back to "Component: {name}" |
spec.lifecycle | spec.lifecycleStage | experimental → development, etc. |
spec.owner | contacts[].email | If in email format |
metadata.tags | tags[] | Cleaned, max 5 tags |
metadata.links | links[] | Max 10 links |
spec.dependsOn | dependencies[] | Default criticality: medium |
github.com/project-slug | spec.repo | org/repo format |