Warum dein Forge-Beispiel aus dem Netz nicht mehr funktioniert

Du suchst ein Beispiel für ein Jira-Panel, findest einen Artikel, kopierst den Code — und beim Ausrollen bricht alles. Der Code war nicht falsch. Er war nur drei Jahre alt.

Zwei Fassungen, ein Name

UI Kit gab es schon einmal. Die erste Fassung arbeitete mit dem Paket @forge/ui, einem einzigen Einstiegspunkt und eigenen Hooks wie useAction. Heute heißt das Paket @forge/react, gerendert wird über ForgeReconciler, und Rahmenkomponenten wie IssuePanel sind ersatzlos entfallen. Beide Fassungen heißen UI Kit — die Suchmaschine unterscheidet sie nicht.

Solcher Code lässt sich nicht anpassen. Er wird übertragen.

Vier Merkmale, ein Blick

Ob ein Beispiel aus der alten Welt stammt, siehst du an vier Stellen:

• der Import aus @forge/ui statt @forge/react
• der Einstiegspunkt ForgeUI.render statt ForgeReconciler.render
• der Hook useAction, den es heute nicht mehr gibt
• eine Rahmenkomponente wie IssuePanel oder AdminPage

Im Manifest fehlt dann meist auch render: native, und statt resource steht dort noch function.

Der Grund, warum es nicht besser wird

Ältere Artikel stehen weiterhin gut auffindbar im Netz — und Sprachmodelle geben die häufigere Fassung wieder, also die alte. Wer einen Coding-Agenten auf eine Forge-App ansetzt, bekommt deshalb oft Code, der plausibel aussieht und erst beim Ausrollen scheitert. Am teuersten wird es, wenn ein Beispiel zur Hälfte übernommen und zur Hälfte angepasst wird: Dann mischen sich beide Fassungen, und die Fehlermeldung zeigt auf die falsche Stelle.

Die Gegenfrage ist nicht „was bedeutet dieser Fehler”, sondern „woher stammt dieser Code”.

Mehr dazu im Seminar

Wie die Übertragung Schritt für Schritt läuft — und wann sich Frame oder Custom UI lohnen —, zeigt das Modul Bestehende Apps und besondere UI-Anforderungen aus dem Seminar Atlassian Forge mit UI Kit — inklusive Video und Kapitelübersicht.

← Alle Beiträge