Update docs to guide users to avoid duplicate title tags when using Inertia Rails to manage meta on the server

bknoles · bknoles · commit 4643417bac94 · 2025-07-29T23:48:19.000-05:00
diff --git a/docs/cookbook/server-managed-meta-tags.md b/docs/cookbook/server-managed-meta-tags.md
@@ -17,13 +17,14 @@ Simply add the `inertia_meta_tags` helper to your layout. This will render the m
 <html>
   <head>
     ...
-    <%= inertia_meta_tags %> <!-- Add this inside your <head> tag -->
+    <%= inertia_meta_tags %> <!-- Add this inside your <head> tag --> // [!code ++]
+    <title inertia>My Inertia App</title> <!-- Remove existing title --> // [!code --]
   </head>
 </html>
 ```
 
 > [!NOTE]
-> If you have a `<title>` tag in your Rails layout, make sure it has the `inertia` attribute on it so Inertia knows it should deduplicate it. The Inertia Rails install generator does this for you automatically.
+> Make sure to remove the `<title>` tag in your Rails layout if you plan to manage it with Inertia Rails. Otherwise you will end up with duplicate `<title>` tags.
 
 ### Client Side
 
@@ -314,13 +315,11 @@ class StoriesController < ApplicationController
     inertia_meta.add({ name: 'article:author', content: 'Tony Gilroy' })
   end
 
-
   # Renders a single article:author meta tag
   def single_author
     render inertia: 'Stories/Show'
   end
 
-
   # Renders multiple article:author meta tags
   def multiple_authors
     render inertia: 'Stories/Show', meta: [
diff --git a/lib/generators/inertia/install/install_generator.rb b/lib/generators/inertia/install/install_generator.rb
@@ -103,7 +103,7 @@ def install_inertia
                              before: '<%= vite_client_tag %>'
           end
 
-          gsub_file application_layout.to_s, /<title>/, '<title inertia>'
+          gsub_file application_layout.to_s, /<title>/, '<title inertia>' unless svelte?
         else
           say_error 'Could not find the application layout file. Please add the following tags manually:', :red
           say_error '-  <title>...</title>'
