Migrate with an AI agent
Point any AI coding agent at one URL and it analyzes your app, asks the right questions, and migrates it to Nucleus step by step.
The fastest way to migrate an existing JetBrains Compose Desktop app is to let an AI coding agent do it, guided by our migration playbook. Nothing to install: the whole playbook — detection script, API references, checkpoints — lives in a single file your agent fetches.
One prompt, that's all
Open your agent (Claude Code, Cursor, Codex, …) inside the app you want to migrate and paste:
Fetch https://nucleusframework.dev/nucleus-migrate.md and follow its instructions to
analyze this app and migrate it to Nucleus step by step.What the agent does
- Scans your project with a bundled detector: AWT/Swing usage (file dialogs, tray,
clipboard,
SwingPanel…), custom title bars, Material 2/3/Jewel, notifications, hand-rolled updaters and single-instance locks, JNA, packaging formats (MSI…), GraalVM feasibility signals, and your CI workflows. - Interviews you: Tao or AWT backend, design system for the window chrome, which native features to adopt (notifications, tray, auto-update, deep links, taskbar progress…), MSI→NSIS, GraalVM now or later, CI migration.
- Migrates one phase at a time — Gradle DSL, window shell, AWT removal, feature adoption,
packaging, GraalVM, CI — each phase ending with a verifiable checkpoint (
./gradlew run, a visual check, a packaged installer) before moving on. - Reports what changed, what was deliberately kept, and what to do next.
Grounded in a real migration
The playbook encodes the DSL renames, threading rules, and the costliest gotchas learned from
real-world migrations (overload ambiguity on NucleusApplicationScope, theme-wraps-window,
HostedWindow for library code, Linux Desktop.browse deadlocks…), all verified against the
plugin and runtime sources.
Claude Code users: install it as a skill (optional)
The same playbook is packaged as a reusable skill with progressive loading (the agent only reads the reference it needs per phase). Download nucleus-migrate.skill, then unzip it into your skills directory:
cd ~/.claude/skills && unzip ~/Downloads/nucleus-migrate.skillFrom any project, run /nucleus-migrate — or just say "migrate this app to Nucleus" and the
skill triggers itself.
Prefer doing it by hand?
Follow the manual guides: build migration from JetBrains Compose Desktop and, coming from Nucleus 1.x, the 1.x to 2.0 guide.
Native spell check
Check spelling in a Kotlin desktop app with PlatformSpellCheckerKt, a wrapper over each operating system's native spell-check engine.
Migrating from JetBrains Compose Desktop
Add Nucleus to an existing JetBrains Compose Desktop project and move its build configuration to the Nucleus DSL.