Add page documenting how to migrate from Spring to Quarkus

_includes/spring-breadcrumb.html

@@ -0,0 +1,7 @@
+<section class="full-width-version-bg flexfilterbar">
+  <div class="guideflexcontainer">
+    <div class="docslink">
+      <a class="returnlink" href="{{site.baseurl}}/spring"> Back to the Spring landing page</a>
+    </div>
+  </div>
+</section>

_includes/spring-migrate-content.html

@@ -0,0 +1,110 @@
+<div class="component-wrapper two-column-content-band">
+
+  <div class="width-12-12">
+    <p>There are two paths from Spring to Quarkus. You can use <strong>compatibility libraries</strong> to run your existing Spring code on Quarkus with minimal changes &mdash; same annotations, same patterns, faster runtime. Or you can <strong>migrate</strong> to native Quarkus APIs (Jakarta REST, CDI, Panache) to get the most out of Quarkus. Either way, you don't have to do it all at once: start with compatibility, then migrate incrementally as it suits you. Both paths are supported by tooling and AI to help automate the work.</p>
+  </div>
+
+  <div class="width-12-12">
+    <h2>Compatibility Libraries</h2>
+    <h3>Spring APIs that work on Quarkus, out of the box</h3>
+    <p>Quarkus provides compatibility extensions that let you reuse your Spring knowledge and code. Use familiar annotations like <code>@RestController</code>, <code>@Autowired</code>, and <code>JpaRepository</code> on a leaner, more productive runtime.</p>
+    <p>To get started: swap in the <a href="{{site.baseurl}}/guides/maven-tooling">Quarkus Maven plugin</a> and BOM, add the compatibility extensions you need, and update your <strong>property names</strong> in <code>application.properties</code> to their Quarkus equivalents.</p>
+    <div class="grid-wrapper">
+      <div class="width-6-12 width-12-12-m">
+        <ul>
+          <li><a href="{{site.baseurl}}/guides/spring-web">Spring Web</a> &mdash; <code>@RestController</code>, <code>@RequestMapping</code>, <code>@GetMapping</code></li>
+          <li><a href="{{site.baseurl}}/guides/spring-di">Spring DI</a> &mdash; <code>@Autowired</code>, <code>@Component</code>, <code>@Service</code></li>
+          <li><a href="{{site.baseurl}}/guides/spring-data-jpa">Spring Data JPA</a> &mdash; <code>JpaRepository</code>, <code>CrudRepository</code>, derived queries</li>
+          <li><a href="{{site.baseurl}}/guides/spring-data-rest">Spring Data REST</a> &mdash; automatic CRUD endpoints from repositories</li>
+          <li><a href="{{site.baseurl}}/guides/spring-security">Spring Security</a> &mdash; <code>@Secured</code>, <code>@PreAuthorize</code></li>
+        </ul>
+      </div>
+      <div class="width-6-12 width-12-12-m">
+        <ul>
+          <li><a href="{{site.baseurl}}/guides/spring-tx">Spring Transactions</a> &mdash; <code>@Transactional</code></li>
+          <li><a href="{{site.baseurl}}/guides/spring-cache">Spring Cache</a> &mdash; <code>@Cacheable</code>, <code>@CacheEvict</code></li>
+          <li><a href="{{site.baseurl}}/guides/spring-boot-properties">Spring Boot Properties</a> &mdash; <code>@ConfigurationProperties</code></li>
+          <li><a href="{{site.baseurl}}/guides/spring-scheduled">Spring Scheduled</a> &mdash; <code>@Scheduled</code> for periodic tasks</li>
+          <li><a href="{{site.baseurl}}/guides/spring-cloud-config-client">Spring Cloud Config</a> &mdash; read config from a Spring Cloud Config Server</li>
+        </ul>
+      </div>
+    </div>
+    <p>These extensions cover the most widely used Spring APIs, but not all of them. If your application uses Spring features that aren't listed here, you'll need to migrate those parts to their Quarkus equivalents &mdash; the tooling and AI resources below can help with that.</p>
+    <p class="textCTA"><i class="fa fa-chevron-right"></i><a href="{{site.baseurl}}/guides/#q=spring">Browse all Spring guides</a></p>
+  </div>
+
+  <div class="width-12-12">
+    <h2>Migrate</h2>
+    <h3>From analysis to automation</h3>
+
+    <h3>Tooling</h3>
+    <div class="grid-wrapper">
+      <div class="width-6-12 width-12-12-m">
+        <div class="imagetext-container">
+          <div class="imagetext-text">
+            <h5>Migration Toolkit for Applications (MTA)</h5>
+            <p>Red Hat's rule-based analysis tool, built on the <a href="https://www.konveyor.io/">Konveyor</a> open source project. MTA analyses your Spring Boot application and produces detailed reports highlighting what needs to change, with guidance on how to fix each issue. Available as a web console, CLI, Maven plugin, or IDE plugin.</p>
+            <p class="textCTA"><i class="fa fa-chevron-right"></i><a href="{{site.baseurl}}/blog/migrating-existing-apps-to-quarkus-with-mta/">Read the MTA migration story</a></p>
+          </div>
+        </div>
+      </div>
+      <div class="width-6-12 width-12-12-m">
+        <div class="imagetext-container">
+          <div class="imagetext-text">
+            <h5>OpenRewrite</h5>
+            <p>The <code>SpringBootToQuarkus</code> composite recipe automates dependency swaps, annotation changes, and configuration migration. Run it via Maven, Gradle, or the CLI with no build changes needed.</p>
+            <p class="textCTA"><i class="fa fa-chevron-right"></i><a href="https://docs.openrewrite.org/recipes/quarkus/spring/springboottoquarkus">OpenRewrite Spring-to-Quarkus recipes</a></p>
+          </div>
+        </div>
+      </div>
+    </div>
+    <div class="grid-wrapper">
+      <div class="width-6-12 width-12-12-m">
+        <div class="imagetext-container">
+          <div class="imagetext-text">
+            <h5>Snowdrop Migration Guide</h5>
+            <p>A structured guide with rules and decision flowcharts for migrating Spring Boot 3.x to Quarkus 3.x. Supports two paths: full Quarkus (Jakarta REST/CDI) or Spring compatibility (quarkus-spring-* extensions). Includes Konveyor analysis rules.</p>
+            <p class="textCTA"><i class="fa fa-chevron-right"></i><a href="https://github.com/snowdrop/springboot-to-quarkus-migration-guide">Snowdrop migration guide on GitHub</a></p>
+          </div>
+        </div>
+      </div>
+    </div>
+
+    <h3>AI</h3>
+    <div class="grid-wrapper">
+      <div class="width-6-12 width-12-12-m">
+        <div class="imagetext-container">
+          <div class="imagetext-text">
+            <h5>AI-Assisted Migration</h5>
+            <p>Modern AI coding assistants understand both Spring and Quarkus patterns well. They can help translate controllers, services, repositories, configuration files, build files, and tests &mdash; giving you a head start on each file you need to migrate. For a <a href="https://www.the-main-thread.com/p/spring-to-quarkus-migration-guide">hands-on walkthrough</a> of what a full migration looks like step by step, see Markus Eisele's guide on The Main Thread, or you can get started with a prompt like "Convert this Spring Boot app to Quarkus".</p>
+          </div>
+        </div>
+      </div>
+      <div class="width-6-12 width-12-12-m">
+        <div class="imagetext-container">
+          <div class="imagetext-text">
+            <h5>Konveyor AI (Kai)</h5>
+            <p>Combines generative AI with static code analysis to assist migration directly in your IDE. Uses a RAG-based approach with historical migration data to provide context-specific guidance, without requiring model fine-tuning.</p>
+            <p class="textCTA"><i class="fa fa-chevron-right"></i><a href="https://konveyor.github.io/components/kai/">Learn about Konveyor AI</a></p>
+          </div>
+        </div>
+      </div>
+    </div>
+    <div class="grid-wrapper">
+      <div class="width-6-12 width-12-12-m">
+        <div class="imagetext-container">
+          <div class="imagetext-text">
+            <h5>Quarkus Spring Migration Skill</h5>
+            <p>To help ensure optimum results and efficiency when using LLMs, we've developed skills. The `quarkus-skills` migration skill guides an AI agent through a full Spring Boot to Quarkus migration &mdash; from reading the codebase to committing the result and opening a draft PR. It inspects your project and decides which modules apply, adapting to your chosen strategy: Spring Compatibility or Native Quarkus.</p>
+            <p class="textCTA"><i class="fa fa-chevron-right"></i><a href="https://github.com/quarkusio/skills#migrate-spring-to-quarkus">Quarkus Skills on GitHub</a></p>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <div class="width-12-12">
+    <p>For more guidance, the free <a href="https://developers.redhat.com/e-books/quarkus-spring-developers" aria-label="Quarkus for Spring Developers free link">Quarkus for Spring Developers e-book</a> explains the similarities and differences between the two frameworks, and helps you map Spring Boot concepts to their Quarkus equivalents.
+  </div>
+
+</div>

_includes/spring-roles-band.html

@@ -63,9 +63,9 @@ <h4>Boost your Java productivity</h4>
             <img class="light-only" src="{{site.baseurl}}/assets/images/icons/icon-norestart.svg" alt="No restart icon">
             <img class="dark-only" src="{{site.baseurl}}/assets/images/icons/icon-norestart-dark.svg" alt="No restart icon">
           </div>
-          <div class="imagetext-text"><H5>Using Spring now? you don’t have to start over.</h5>
+          <div class="imagetext-text"><h5>Using Spring now? you don’t have to start over.</h5>
             <p>Quarkus speaks fluent Spring. Reuse your @RestController, @Autowired, and JpaRepository code with Spring compatibility extensions. You get the same familiar APIs, now backed by a faster, more modern runtime.</p>
-            <p class="textCTA"><i class="fa fa-chevron-right"></i><a href="{{site.baseurl}}/guides/#q=spring">Start your journey with these excellent Spring guides</a></p>
+            <p class="textCTA"><i class="fa fa-chevron-right"></i><a href="{{site.baseurl}}/spring/migrate">Ready to migrate? See our migration guide</a></p>
           </div>
         </div>
         <div class="imagetext-container">

_layouts/spring-migrate.html

@@ -0,0 +1,8 @@
+---
+layout: base
+---
+
+{% include spring-breadcrumb.html %}
+{% include springtitle-band.html %}
+
+{% include spring-migrate-content.html %}

_redirects/migrate-to-quarkus.md

@@ -0,0 +1,4 @@
+---
+permalink: /migrate-to-quarkus/
+newUrl: /spring/migrate
+---

spring-migrate.md

@@ -0,0 +1,7 @@
+---
+layout: spring-migrate
+title: Migrate from Spring to Quarkus
+permalink: /spring/migrate/
+subtitle: Everything You Need to Move to Quarkus
+
+---