inertia_rails 3.4.0 → 3.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 58d0616b3504cdbe3a0002ea2568b8af2bf8ab442882115109c1c4fcd636fbf2
-  data.tar.gz: ad704410b5c41f0c75a6dc6b2029e9e3742ec16539ab607414f86d0c63a7a397
+  metadata.gz: 1703f19fcb6d8f3d2c580e6e7bd80ff999cda8f55f72f7ea915001279577386c
+  data.tar.gz: d5ff27be81328583e03aa7eb4473f1a4a966139993a3d856c54c0b6ae447b122
 SHA512:
-  metadata.gz: b19bade9694bad666820b90e25727658679ce057c06c501f95344d70cbced198ed217d5f965d8146eb303ae48794675e93da9cd371c012afb8965533cf8c9eba
-  data.tar.gz: 1a1ce123b90feecc66c211ea38cbcd4a3db6d2696ec0807a0e196baad99b32901d205fefae38497db2eba22d8da7f7dbc8b2923c20474f6626d639e7c033a99d
+  metadata.gz: 9cdd9eebf261e555bc09d237272852c4c59cf08618462f5deb5aaa314e09538e121a8c116e989c9c66632f38d2bcf14617d0d0f6ca9f5fe152e7b646a5a652f3
+  data.tar.gz: 4fea8b1605262d6d80ccec45fe68368b9f62ae4cd96cca7768b58b0b65e5a690877216f6f10f7d4e93915cbba8003b4635b99ea4b3af3f2100bceda8c572cd73

data/CHANGELOG.md

@@ -4,6 +4,28 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.6.0] - 2024-12-13
+
+Support for the v2.0 Inertia.js release! It's a minor bump because there are no breaking changes!
+
+Kudos to @skryukov and @PedroAugustoRamalhoDuarte for driving the features in this release!
+
+* InertiaRails.defer for deferred props
+* History encryption
+* InertiaRails.merge for merge props
+* InertiaRails.optional props (replaces lazy props in v2.0, InertiaRails.lazy now has a deprecation warning)
+
+## [3.5.0] - 2024-11-29
+
+* Add Algolia search for docs (#151, @skryukov)
+* Add support for Always props (#152, @skryukov)
+* Add support for :except in partial reloads (#152, @skryukov)
+* CI fixes (#156, @bknoles)
+* Support dot notation for :only partial reloads (#163, @bknoles)
+* Avoid some monkey patching (#164, @adrianpacala)
+* Upstream generators from inertia_rails-contrib (#158, @skryukov)
+* Raise a deprecation warning instead of an exception if you pass a non-hashable to inertia errors (#168, @skryukov)
+
 ## [3.4.0] - 2024-11-02
 
 * Inertia Rails documentation (@skryukov)

data/README.md

@@ -13,16 +13,15 @@ Add the `inertia_rails` gem to your Gemfile.
 gem 'inertia_rails'
 ```
 
-For more instructions, see [Server-side setup](https://inertia-rails.netlify.app/guide/server-side-setup.html).
+Follow the complete [Server-side setup](https://inertia-rails.dev/guide/server-side-setup) in the official documentation.
 
 ### Frontend
 
-We are discussing on bringing official docs for Inertia Rails to this repo, as
-the [official docs](https://inertiajs.com/client-side-setup) are specific to Laravel.
+Follow the [Client-side setup](https://inertia-rails.dev/guide/client-side-setup) guide for detailed configuration steps.
 
-In the meantime, you can refer to the community-maintained [Client-side setup](https://inertia-rails.netlify.app/guide/client-side-setup.html).
+### Example Projects:
 
-Examples:
+Reference these sample implementations:
 
 - [React/Vite](https://github.com/BrandonShar/inertia-rails-template)
 - [React/Vite + SSR](https://github.com/ElMassimo/inertia-rails-ssr-template)
@@ -103,11 +102,11 @@ end
 
 ### Shared Data
 
-If you have data that you want to be provided as a prop to every component (a common use-case is information about the authenticated user) you can use the `shared_data` controller method.
+If you have data that you want to be provided as a prop to every component (a common use-case is information about the authenticated user) you can use the `inertia_share` controller method.
 
 ```ruby
 class EventsController < ApplicationController
-  # share syncronously
+  # share synchronously
   inertia_share app_name: env['app.name']
   
   # share lazily, evaluated at render time
@@ -189,15 +188,12 @@ end
 }
 ```
 
-### Lazy Props
+### Optional Props
 
-On the front end, Inertia supports the concept of "partial reloads" where only the props requested are returned by the server. Sometimes, you may want to use this flow to avoid processing a particularly slow prop on the intial load. In this case, you can use Lazy props. Lazy props aren't evaluated unless they're specifically requested by name in a partial reload.
+On the frontend, Inertia supports the concept of "partial reloads" where only the props requested are returned by the server. Sometimes, you may want to use this flow to avoid processing a particularly slow prop on the initial load. In this case, you can use Optional props. Optional props aren't evaluated unless they're specifically requested by name in a partial reload.
 
 ```ruby
-  inertia_share some_data: InertiaRails.lazy(lambda { some_very_slow_method })
-
-  # Using a Ruby block syntax
-  inertia_share some_data: InertiaRails.lazy { some_very_slow_method }
+  inertia_share some_data: InertiaRails.optional { some_very_slow_method }
 ```
 
 ### Routing
@@ -270,6 +266,14 @@ end
 
   __Default__: `false`
 
+#### `encrypt_history`
+
+  When enabled, you instruct Inertia to encrypt your app's history, it uses
+  the browser's built-in [`crypto` api](https://developer.mozilla.org/en-US/docs/Web/API/Crypto)
+  to encrypt the current page's data before pushing it to the history state.
+
+  __Default__: `false`
+
 #### `ssr_enabled` _(experimental)_
 
   Whether to use a JavaScript server to pre-render your JavaScript pages,

data/lib/generators/inertia/controller/controller_generator.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require 'rails/generators/rails/controller/controller_generator'
+require 'inertia_rails/generators/helper'
+
+module Inertia
+  module Generators
+    class ControllerGenerator < Rails::Generators::ControllerGenerator
+      include InertiaRails::Generators::Helper
+
+      source_root File.expand_path('./templates', __dir__)
+
+      remove_hook_for :template_engine
+
+      hook_for :inertia_templates, required: true, default: InertiaRails::Generators::Helper.guess_inertia_template
+    end
+  end
+end

data/lib/generators/inertia/controller/templates/controller.rb.tt

@@ -0,0 +1,10 @@
+<% module_namespacing do -%>
+class <%= class_name %>Controller < <%= parent_class_name.classify %>
+<% actions.each do |action| -%>
+  def <%= action %>
+    render inertia: '<%= "#{inertia_base_path}/#{action.camelize}" %>'
+  end
+<%= "\n" unless action == actions.last -%>
+<% end -%>
+end
+<% end -%>

data/lib/generators/inertia/install/frameworks.yml

@@ -0,0 +1,98 @@
+react:
+  inertia_package: "@inertiajs/react"
+  packages:
+    - "@vitejs/plugin-react"
+    - "react"
+    - "react-dom"
+  packages_ts:
+    - "@types/react"
+    - "@types/react-dom"
+    - "typescript"
+  vite_plugin_import: "import react from '@vitejs/plugin-react'"
+  vite_plugin_call: "react()"
+  copy_files_ts:
+    "InertiaExample.tsx": "%{js_destination_path}/pages/InertiaExample.tsx"
+    "tsconfig.json": "tsconfig.json"
+    "tsconfig.app.json": "tsconfig.app.json"
+    "tsconfig.node.json": "tsconfig.node.json"
+    "vite-env.d.ts": "%{js_destination_path}/vite-env.d.ts"
+  copy_files_js:
+    "InertiaExample.jsx": "%{js_destination_path}/pages/InertiaExample.jsx"
+  copy_files:
+    "InertiaExample.module.css": "%{js_destination_path}/pages/InertiaExample.module.css"
+    "../assets/react.svg": "%{js_destination_path}/assets/react.svg"
+    "../assets/inertia.svg": "%{js_destination_path}/assets/inertia.svg"
+    "../assets/vite_ruby.svg": "%{js_destination_path}/assets/vite_ruby.svg"
+
+vue:
+  inertia_package: "@inertiajs/vue3"
+  packages:
+    - "vue"
+    - "@vitejs/plugin-vue"
+  packages_ts:
+    - "typescript@~5.6.2"
+    - "vue-tsc"
+  vite_plugin_import: "import vue from '@vitejs/plugin-vue'"
+  vite_plugin_call: "vue()"
+  copy_files:
+    "../assets/vue.svg": "%{js_destination_path}/assets/vue.svg"
+    "../assets/inertia.svg": "%{js_destination_path}/assets/inertia.svg"
+    "../assets/vite_ruby.svg": "%{js_destination_path}/assets/vite_ruby.svg"
+  copy_files_ts:
+    "InertiaExample.ts.vue": "%{js_destination_path}/pages/InertiaExample.vue"
+    "tsconfig.json": "tsconfig.json"
+    "tsconfig.app.json": "tsconfig.app.json"
+    "tsconfig.node.json": "tsconfig.node.json"
+    "vite-env.d.ts": "%{js_destination_path}/vite-env.d.ts"
+  copy_files_js:
+    "InertiaExample.vue": "%{js_destination_path}/pages/InertiaExample.vue"
+
+svelte4:
+  inertia_package: "@inertiajs/svelte"
+  packages:
+    - "svelte@4"
+    - "@sveltejs/vite-plugin-svelte@3"
+  packages_ts:
+    - "@tsconfig/svelte@4"
+    - "svelte-check"
+    - "typescript"
+    - "tslib"
+  vite_plugin_import: "import { svelte } from '@sveltejs/vite-plugin-svelte'"
+  vite_plugin_call: "svelte()"
+  copy_files_ts:
+    "InertiaExample.ts.svelte": "%{js_destination_path}/pages/InertiaExample.svelte"
+    "tsconfig.json": "tsconfig.json"
+    "tsconfig.node.json": "tsconfig.node.json"
+    "vite-env.d.ts": "%{js_destination_path}/vite-env.d.ts"
+  copy_files_js:
+    "InertiaExample.svelte": "%{js_destination_path}/pages/InertiaExample.svelte"
+  copy_files:
+    "svelte.config.js": "svelte.config.js"
+    "../assets/svelte.svg": "%{js_destination_path}/assets/svelte.svg"
+    "../assets/inertia.svg": "%{js_destination_path}/assets/inertia.svg"
+    "../assets/vite_ruby.svg": "%{js_destination_path}/assets/vite_ruby.svg"
+
+svelte:
+  inertia_package: "@inertiajs/svelte"
+  packages:
+    - "svelte@5"
+    - "@sveltejs/vite-plugin-svelte@4"
+  packages_ts:
+    - "@tsconfig/svelte@5"
+    - "svelte-check"
+    - "typescript"
+    - "tslib"
+  vite_plugin_import: "import { svelte } from '@sveltejs/vite-plugin-svelte'"
+  vite_plugin_call: "svelte()"
+  copy_files_ts:
+    "InertiaExample.ts.svelte": "%{js_destination_path}/pages/InertiaExample.svelte"
+    "tsconfig.json": "tsconfig.json"
+    "tsconfig.node.json": "tsconfig.node.json"
+    "vite-env.d.ts": "%{js_destination_path}/vite-env.d.ts"
+  copy_files_js:
+    "InertiaExample.svelte": "%{js_destination_path}/pages/InertiaExample.svelte"
+  copy_files:
+    "svelte.config.js": "svelte.config.js"
+    "../assets/svelte.svg": "%{js_destination_path}/assets/svelte.svg"
+    "../assets/inertia.svg": "%{js_destination_path}/assets/inertia.svg"
+    "../assets/vite_ruby.svg": "%{js_destination_path}/assets/vite_ruby.svg"

data/lib/generators/inertia/install/helpers.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Inertia
+  module Generators
+    module Helpers
+      ### FS Helpers
+      def js_destination_path
+        return ViteRuby.config.source_code_dir if defined?(ViteRuby)
+
+        if file?('config/vite.json')
+          source_code_dir = JSON.parse(File.read(file_path('config/vite.json'))).dig('all', 'sourceCodeDir')
+          return source_code_dir if source_code_dir
+        end
+
+        'app/frontend'
+      end
+
+      def js_destination_root
+        file_path(js_destination_path)
+      end
+
+      def js_file_path(*relative_path)
+        File.join(js_destination_root, *relative_path)
+      end
+
+      def file?(*relative_path)
+        File.file?(file_path(*relative_path))
+      end
+
+      def file_path(*relative_path)
+        File.join(destination_root, *relative_path)
+      end
+
+      # Interactivity Helpers
+      def ask(*)
+        unless options[:interactive]
+          say_error 'Specify all options when running the generator non-interactively.', :red
+          exit(1)
+        end
+
+        super
+      end
+
+      def yes?(*)
+        return false unless options[:interactive]
+
+        super
+      end
+    end
+  end
+end

data/lib/generators/inertia/install/install_generator.rb

@@ -0,0 +1,291 @@
+# frozen_string_literal: true
+
+require 'yaml'
+require 'rails/generators'
+require 'rails/generators/base'
+
+require_relative 'helpers'
+require_relative 'js_package_manager'
+
+module Inertia
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      include Helpers
+
+      FRAMEWORKS = YAML.load_file(File.expand_path('./frameworks.yml', __dir__))
+
+      source_root File.expand_path('./templates', __dir__)
+
+      class_option :framework, type: :string,
+                               desc: 'The framework you want to use with Inertia',
+                               enum: FRAMEWORKS.keys,
+                               default: nil
+
+      class_option :inertia_version, type: :string, default: 'latest',
+                                     desc: 'The version of Inertia.js to install'
+
+      class_option :typescript, type: :boolean, default: false,
+                                desc: 'Whether to use TypeScript'
+
+      class_option :package_manager, type: :string, default: nil,
+                                     enum: JSPackageManager.package_managers,
+                                     desc: "The package manager you want to use to install Inertia's npm packages"
+
+      class_option :interactive, type: :boolean, default: true,
+                                 desc: 'Whether to prompt for optional installations'
+
+      class_option :tailwind, type: :boolean, default: false,
+                              desc: 'Whether to install Tailwind CSS'
+      class_option :vite, type: :boolean, default: false,
+                          desc: 'Whether to install Vite Ruby'
+      class_option :example_page, type: :boolean, default: true,
+                                  desc: 'Whether to add an example Inertia page'
+
+      class_option :verbose, type: :boolean, default: false,
+                             desc: 'Run the generator in verbose mode'
+
+      remove_class_option :skip_namespace, :skip_collision_check
+
+      def install
+        say "Installing Inertia's Rails adapter"
+
+        if inertia_resolved_version.version == '0'
+          say_error "Could not find the Inertia.js package version #{options[:inertia_version]}.", :red
+          exit(false)
+        end
+
+        install_vite unless ruby_vite_installed?
+
+        install_typescript if typescript?
+
+        install_tailwind if install_tailwind?
+
+        install_inertia
+
+        install_example_page if options[:example_page]
+
+        say 'Copying bin/dev'
+        copy_file "#{__dir__}/templates/dev", 'bin/dev'
+        chmod 'bin/dev', 0o755, verbose: verbose?
+
+        say "Inertia's Rails adapter successfully installed", :green
+      end
+
+      private
+
+      def install_inertia
+        say "Adding Inertia's Rails adapter initializer"
+        template 'initializer.rb', file_path('config/initializers/inertia_rails.rb')
+
+        say 'Installing Inertia npm packages'
+        add_dependencies(*FRAMEWORKS[framework]['packages'])
+        add_dependencies(inertia_package)
+
+        unless File.read(vite_config_path).include?(FRAMEWORKS[framework]['vite_plugin_import'])
+          say "Adding Vite plugin for #{framework}"
+          insert_into_file vite_config_path, "\n    #{FRAMEWORKS[framework]['vite_plugin_call']},", after: 'plugins: ['
+          prepend_file vite_config_path, "#{FRAMEWORKS[framework]['vite_plugin_import']}\n"
+        end
+
+        say "Copying #{inertia_entrypoint} entrypoint"
+        template "#{framework}/#{inertia_entrypoint}", js_file_path("entrypoints/#{inertia_entrypoint}")
+
+        if application_layout.exist?
+          say "Adding #{inertia_entrypoint} script tag to the application layout"
+          headers = <<-ERB
+    <%= #{vite_tag} "inertia" %>
+    <%= inertia_ssr_head %>
+          ERB
+          insert_into_file application_layout.to_s, headers, after: "<%= vite_client_tag %>\n"
+
+          if framework == 'react' && !application_layout.read.include?('vite_react_refresh_tag')
+            say 'Adding Vite React Refresh tag to the application layout'
+            insert_into_file application_layout.to_s, "<%= vite_react_refresh_tag %>\n    ",
+                             before: '<%= vite_client_tag %>'
+          end
+
+          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>'
+          say_error '+  <title inertia>...</title>'
+          say_error '+  <%= inertia_ssr_head %>'
+          say_error '+  <%= vite_react_refresh_tag %>' if framework == 'react'
+          say_error "+  <%= #{vite_tag} \"inertia\" %>"
+        end
+      end
+
+      def install_typescript
+        say 'Adding TypeScript support'
+        if svelte? && inertia_resolved_version.release < Gem::Version.new('1.3.0')
+          say 'WARNING: @inertiajs/svelte < 1.3.0 does not support TypeScript ' \
+              "(resolved version: #{inertia_resolved_version}).",
+              :yellow
+          say 'Skipping TypeScript support for @inertiajs/svelte', :yellow
+          @typescript = false
+          return
+        end
+
+        add_dependencies(*FRAMEWORKS[framework]['packages_ts'])
+
+        say 'Copying adding scripts to package.json'
+        run 'npm pkg set scripts.check="svelte-check --tsconfig ./tsconfig.json && tsc -p tsconfig.node.json"' if svelte?
+        run 'npm pkg set scripts.check="vue-tsc -p tsconfig.app.json && tsc -p tsconfig.node.json"' if framework == 'vue'
+        run 'npm pkg set scripts.check="tsc -p tsconfig.app.json && tsc -p tsconfig.node.json"' if framework == 'react'
+      end
+
+      def install_example_page
+        say 'Copying example Inertia controller'
+        template 'controller.rb', file_path('app/controllers/inertia_example_controller.rb')
+
+        say 'Adding a route for the example Inertia controller'
+        route "get 'inertia-example', to: 'inertia_example#index'"
+
+        say 'Copying page assets'
+        copy_files = FRAMEWORKS[framework]['copy_files'].merge(
+          FRAMEWORKS[framework]["copy_files_#{typescript? ? 'ts' : 'js'}"]
+        )
+        copy_files.each do |source, destination|
+          template "#{framework}/#{source}", file_path(format(destination, js_destination_path: js_destination_path))
+        end
+      end
+
+      def install_tailwind
+        say 'Installing Tailwind CSS'
+        add_dependencies(%w[tailwindcss postcss autoprefixer @tailwindcss/forms @tailwindcss/typography
+                            @tailwindcss/container-queries])
+
+        template 'tailwind/tailwind.config.js', file_path('tailwind.config.js')
+        copy_file 'tailwind/postcss.config.js', file_path('postcss.config.js')
+        copy_file 'tailwind/application.css', js_file_path('entrypoints/application.css')
+
+        if application_layout.exist?
+          say 'Adding Tailwind CSS to the application layout'
+          insert_into_file application_layout.to_s, "<%= vite_stylesheet_tag \"application\" %>\n    ",
+                           before: '<%= vite_client_tag %>'
+        else
+          say_error 'Could not find the application layout file. Please add the following tags manually:', :red
+          say_error '+  <%= vite_stylesheet_tag "application" %>' if install_tailwind?
+        end
+      end
+
+      def install_vite
+        unless install_vite?
+          say_error 'This generator only supports Ruby on Rails with Vite.', :red
+          exit(false)
+        end
+
+        in_root do
+          Bundler.with_original_env do
+            if (capture = run('bundle add vite_rails', capture: !verbose?))
+              say 'Vite Rails gem successfully installed', :green
+            else
+              say capture
+              say_error 'Failed to install Vite Rails gem', :red
+              exit(false)
+            end
+            if (capture = run('bundle exec vite install', capture: !verbose?))
+              say 'Vite Rails successfully installed', :green
+            else
+              say capture
+              say_error 'Failed to install Vite Rails', :red
+              exit(false)
+            end
+          end
+        end
+      end
+
+      def ruby_vite_installed?
+        return true if package_manager.present? && ruby_vite?
+
+        if !package_manager.present?
+          say_status 'Could not find a package.json file to install Inertia to.', nil
+        elsif gem_installed?('webpacker') || gem_installed?('shakapacker')
+          say 'Webpacker or Shakapacker is installed.', :yellow
+          say 'Vite Ruby can work alongside Webpacker or Shakapacker, but it might cause issues.', :yellow
+          say 'Please see the Vite Ruby documentation for the migration guide:', :yellow
+          say 'https://vite-ruby.netlify.app/guide/migration.html#webpacker-%F0%9F%93%A6', :yellow
+        else
+          say_status 'Could not find a Vite configuration files ' \
+                     '(`config/vite.json` & `vite.config.{ts,js,mjs,cjs,mts,cts}`).',
+                     nil
+        end
+        false
+      end
+
+      def gem_installed?(name)
+        regex = /^[^#]*gem\s+['"]#{name}['"]/
+        File.read(file_path('Gemfile')).match?(regex)
+      end
+
+      def application_layout
+        @application_layout ||= Pathname.new(file_path('app/views/layouts/application.html.erb'))
+      end
+
+      def ruby_vite?
+        file?('config/vite.json') && vite_config_path
+      end
+
+      def package_manager
+        @package_manager ||= JSPackageManager.new(self)
+      end
+
+      def add_dependencies(*packages)
+        package_manager.add_dependencies(*packages)
+      end
+
+      def vite_config_path
+        @vite_config_path ||= Dir.glob(file_path('vite.config.{ts,js,mjs,cjs,mts,cts}')).first
+      end
+
+      def install_vite?
+        return @install_vite if defined?(@install_vite)
+
+        @install_vite = options[:vite] || yes?('Would you like to install Vite Ruby? (y/n)', :green)
+      end
+
+      def install_tailwind?
+        return @install_tailwind if defined?(@install_tailwind)
+
+        @install_tailwind = options[:tailwind] || yes?('Would you like to install Tailwind CSS? (y/n)', :green)
+      end
+
+      def typescript?
+        return @typescript if defined?(@typescript)
+
+        @typescript = options[:typescript] || yes?('Would you like to use TypeScript? (y/n)', :green)
+      end
+
+      def inertia_entrypoint
+        "inertia.#{typescript? ? 'ts' : 'js'}"
+      end
+
+      def vite_tag
+        typescript? ? 'vite_typescript_tag' : 'vite_javascript_tag'
+      end
+
+      def inertia_resolved_version
+        @inertia_resolved_version ||= Gem::Version.new(
+          `npm show @inertiajs/core@#{options[:inertia_version]} version`.strip
+        )
+      end
+
+      def verbose?
+        options[:verbose]
+      end
+
+      def svelte?
+        framework.start_with? 'svelte'
+      end
+
+      def inertia_package
+        "#{FRAMEWORKS[framework]['inertia_package']}@#{options[:inertia_version]}"
+      end
+
+      def framework
+        @framework ||= options[:framework] || ask('What framework do you want to use with Inertia?', :green,
+                                                  limited_to: FRAMEWORKS.keys, default: 'react')
+      end
+    end
+  end
+end

data/lib/generators/inertia/install/js_package_manager.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Inertia
+  module Generators
+    class JSPackageManager
+      def self.package_managers
+        %w[npm yarn bun pnpm]
+      end
+
+      def initialize(generator)
+        @generator = generator
+      end
+
+      def present?
+        package_manager.present?
+      end
+
+      def add_dependencies(*dependencies)
+        options = @generator.options[:verbose] ? '' : ' --silent'
+        @generator.in_root do
+          @generator.run "#{package_manager} add #{dependencies.join(' ')}#{options}"
+        end
+      end
+
+      private
+
+      def package_manager
+        @package_manager ||= @generator.options[:package_manager] || detect_package_manager
+      end
+
+      def detect_package_manager
+        return nil unless file?('package.json')
+
+        if file?('package-lock.json')
+          'npm'
+        elsif file?('bun.lockb')
+          'bun'
+        elsif file?('pnpm-lock.yaml')
+          'pnpm'
+        else
+          'yarn'
+        end
+      end
+
+      def file?(*relative_path)
+        @generator.file?(*relative_path)
+      end
+    end
+  end
+end

data/lib/generators/inertia/install/templates/assets/inertia.svg

@@ -0,0 +1 @@
+<svg width="100%" height="100%" viewBox="0 0 400 400" xmlns="http://www.w3.org/2000/svg"><linearGradient id="a" x1="0" y1="200" x2="400" y2="200" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#9653ea"/><stop offset="1" stop-color="#6e74ef"/></linearGradient><path fill="url(#a)" fill-rule="evenodd" d="M400 200C400 89.543 310.457 0 200 0S0 89.543 0 200s89.543 200 200 200 200-89.543 200-200Z"/><path fill="#fff" d="M137.331 117.6H52.4l82.069 82.069L52.4 281.737h84.931L219.4 199.67Z"/><path fill="#fff" d="M265.231 117.6H180.3l82.069 82.069-82.069 82.068h84.931L347.3 199.67Z"/></svg>

data/lib/generators/inertia/install/templates/assets/react.svg

@@ -0,0 +1 @@
+<svg viewBox="-10.5 -9.45 21 18.9" fill="none" xmlns="http://www.w3.org/2000/svg" class="uwu-hidden mt-4 mb-3 text-brand dark:text-brand-dark w-24 lg:w-28 self-center text-sm me-0 flex origin-center transition-all ease-in-out"><circle r="2" fill="#58C4DC"/><g stroke="#58C4DC"><ellipse rx="10" ry="4.5"/><ellipse rx="10" ry="4.5" transform="rotate(60)"/><ellipse rx="10" ry="4.5" transform="rotate(120)"/></g></svg>

data/lib/generators/inertia/install/templates/assets/svelte.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" class="iconify iconify--logos" width="26.6" height="32" viewBox="0 0 256 308"><path fill="#FF3E00" d="M239.682 40.707C211.113-.182 154.69-12.301 113.895 13.69L42.247 59.356a82.198 82.198 0 0 0-37.135 55.056 86.566 86.566 0 0 0 8.536 55.576 82.425 82.425 0 0 0-12.296 30.719 87.596 87.596 0 0 0 14.964 66.244c28.574 40.893 84.997 53.007 125.787 27.016l71.648-45.664a82.182 82.182 0 0 0 37.135-55.057 86.601 86.601 0 0 0-8.53-55.577 82.409 82.409 0 0 0 12.29-30.718 87.573 87.573 0 0 0-14.963-66.244"/><path fill="#FFF" d="M106.889 270.841c-23.102 6.007-47.497-3.036-61.103-22.648a52.685 52.685 0 0 1-9.003-39.85 49.978 49.978 0 0 1 1.713-6.693l1.35-4.115 3.671 2.697a92.447 92.447 0 0 0 28.036 14.007l2.663.808-.245 2.659a16.067 16.067 0 0 0 2.89 10.656 17.143 17.143 0 0 0 18.397 6.828 15.786 15.786 0 0 0 4.403-1.935l71.67-45.672a14.922 14.922 0 0 0 6.734-9.977 15.923 15.923 0 0 0-2.713-12.011 17.156 17.156 0 0 0-18.404-6.832 15.78 15.78 0 0 0-4.396 1.933l-27.35 17.434a52.298 52.298 0 0 1-14.553 6.391c-23.101 6.007-47.497-3.036-61.101-22.649a52.681 52.681 0 0 1-9.004-39.849 49.428 49.428 0 0 1 22.34-33.114l71.664-45.677a52.218 52.218 0 0 1 14.563-6.398c23.101-6.007 47.497 3.036 61.101 22.648a52.685 52.685 0 0 1 9.004 39.85 50.559 50.559 0 0 1-1.713 6.692l-1.35 4.116-3.67-2.693a92.373 92.373 0 0 0-28.037-14.013l-2.664-.809.246-2.658a16.099 16.099 0 0 0-2.89-10.656 17.143 17.143 0 0 0-18.398-6.828 15.786 15.786 0 0 0-4.402 1.935l-71.67 45.674a14.898 14.898 0 0 0-6.73 9.975 15.9 15.9 0 0 0 2.709 12.012 17.156 17.156 0 0 0 18.404 6.832 15.841 15.841 0 0 0 4.402-1.935l27.345-17.427a52.147 52.147 0 0 1 14.552-6.397c23.101-6.006 47.497 3.037 61.102 22.65a52.681 52.681 0 0 1 9.003 39.848 49.453 49.453 0 0 1-22.34 33.12l-71.664 45.673a52.218 52.218 0 0 1-14.563 6.398"/></svg>

data/lib/generators/inertia/install/templates/assets/vite_ruby.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 366 304" fill="none"><path d="M91.95 46.973a5.5 5.5 0 0 0-.401.722l-59.724 69.638a5.5 5.5 0 0 0 .003 7.165l147 171.086a5.502 5.502 0 0 0 8.344 0l147-171.084a5.5 5.5 0 0 0 .003-7.165l-59.723-69.637a5.5 5.5 0 0 0-4.996-3.198H96.543a5.5 5.5 0 0 0-4.592 2.473z" fill="url(#a)" stroke="url(#b)" stroke-width="11" stroke-linecap="round" stroke-linejoin="round"/><path d="m265.857 19.004-116.154 5.598a4.346 4.346 0 0 0-3.643 3.885v109.121c-.267 2.885 2.326 5.217 5.182 4.659l20.815-4.659c3.114-.608 5.819 2.194 5.082 5.268l-8.01 45.423c-.767 3.199 2.18 6.052 5.371 5.201l17.232-3.395c3.195-.852 6.144 2.01 5.369 5.211l-18.069 74.653c-1.13 4.67 5.068 7.44 7.82 3.495l1.838-2.635L291.703 81.887c1.725-3.163-.947-6.923-4.518-6.357l-34.224 5.417c-3.217.508-5.839-2.544-4.834-5.627l22.576-50.691c1.006-3.088-1.626-6.144-4.846-5.625z" fill="url(#c)"/><defs><linearGradient id="a" x1="28.5" y1="34" x2="246.355" y2="194.428" gradientUnits="userSpaceOnUse"><stop stop-color="#FF006B"/><stop offset=".364" stop-color="#C00"/><stop offset="1" stop-color="#980D03"/></linearGradient><linearGradient id="b" x1="28.5" y1="34" x2="246.355" y2="194.428" gradientUnits="userSpaceOnUse"><stop stop-color="#FF006B"/><stop offset=".364" stop-color="#C00"/><stop offset="1" stop-color="#980D03"/></linearGradient><linearGradient id="c" x1="183.666" y1="-5.499" x2="211.353" y2="242.278" gradientUnits="userSpaceOnUse"><stop stop-color="#FFDD35"/><stop offset=".083" stop-color="#FFD233"/><stop offset=".594" stop-color="#FFA800"/><stop offset=".839" stop-color="#F90"/></linearGradient></defs></svg>

data/lib/generators/inertia/install/templates/assets/vue.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" class="iconify iconify--logos" width="37.07" height="36" viewBox="0 0 256 198"><path fill="#41B883" d="M204.8 0H256L128 220.8 0 0h97.92L128 51.2 157.44 0h47.36Z"/><path fill="#41B883" d="m0 0 128 220.8L256 0h-51.2L128 132.48 50.56 0H0Z"/><path fill="#35495E" d="M50.56 0 128 133.12 204.8 0h-47.36L128 51.2 97.92 0H50.56Z"/></svg>

data/lib/generators/{inertia_rails/install → inertia/install/templates}/controller.rb

@@ -1,7 +1,9 @@
+# frozen_string_literal: true
+
 class InertiaExampleController < ApplicationController
   def index
     render inertia: 'InertiaExample', props: {
-      name: 'World',
+      name: params.fetch(:name, 'World'),
     }
   end
 end