app-frontend-system-migration

Migrate Backstage apps from the old frontend system to the extension-based frontend system.

34.1k|7.5k|Updated Jan 24, 2020
One-click install
npx skills add https://github.com/backstage/backstage --skill app-frontend-system-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: app-frontend-system-migration
Source: https://github.com/backstage/backstage/tree/main/docs/.well-known/skills/app-frontend-system-migration
Command: npx skills add https://github.com/backstage/backstage --skill app-frontend-system-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured approach to migrating a Backstage app from the old frontend system to the new extension-based frontend system, covering the two-phase hybrid migration and the full migration of routes, sidebar, plugins, APIs, themes, and other app-level concerns.

Core Features & Use Cases

  • Hybrid migration guidance to bridge legacy apps with the new frontend system during Phase 1.
  • Step-by-step conversion of app root, routes, and configuration to enable automatic feature discovery and a seamless upgrade.
  • End-to-end migration best practices for Phase 2, including APIs, themes, icons, translations, and entity pages, to fully adopt the extension-based frontend.

Quick Start

Begin by switching the app's createApp import to @backstage/frontend-defaults and enabling feature discovery to start the hybrid migration.

Frequently Asked Questions about app-frontend-system-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate a Backstage app to the new frontend system?

To migrate a Backstage app to the new extension-based frontend system, switch your createApp import to @backstage/frontend-defaults and enable feature discovery to start the Phase 1 hybrid migration process.

What is the difference between Phase 1 hybrid migration and Phase 2 full migration in Backstage?

Phase 1 hybrid migration bridges legacy apps with the new frontend system by converting app roots and enabling feature discovery. Phase 2 fully transitions routes, plugins, APIs, themes, and icons to the extension-based architecture.

How do I convert Backstage routes and sidebars to the new frontend system?

Converting Backstage routes and sidebars involves transitioning to frontend modules with appropriate tooling and configuration during the migration phases to fully adopt the extension-based frontend architecture.

Can I migrate Backstage themes, APIs, and entity pages to the extension-based frontend?

Yes, Phase 2 full migration provides end-to-end best practices for transitioning themes, APIs, icons, translations, and entity pages to fully adopt the extension-based Backstage frontend system.

Does Backstage hybrid migration support automatic feature discovery?

Yes, Backstage hybrid migration supports automatic feature discovery by prescribing the conversion of app roots, routes, and configuration to enable a seamless upgrade to the new extension-based frontend system.