SuperAPI AI 工具集

inertia-rails-setup

通用与其它

查看项目

更新于 10-15 20:14

技能介绍

用途:在 Ruby on Rails 应用中搭建 Inertia.js,可选择 React、Vue 或 Svelte 作为前端框架,适用于新建项目或为现有 Rails 应用添加 Inertia。

主要能力:提供官方启动套件(React、Vue、Svelte),内置认证、shadcn/ui 组件、TypeScript 与可选 SSR;也提供生成器与手动配置步骤,涵盖 Gem 安装、Vite Rails 集成、根布局、前端入口、页面目录、初始化器、共享数据与首个页面。

使用方式:新项目可克隆启动套件,例如 git clone https://github.com/inertia-rails/react-starter-kit myapp,然后 cd myapp 并运行 bin/setup。从零开始或接入现有应用时,可执行 rails new myapp --skip-javascript、bundle add inertia_rails、bin/rails generate inertia:install,生成器会询问前端框架、TypeScript 与 Tailwind CSS。手动步骤包括添加 gem 'inertia_rails'、bundle add vite_rails 与 bundle exec vite install、配置 app/views/layouts/application.html.erb、安装前端依赖(如 npm install @inertiajs/react @inertiajs/vite react react-dom)、创建 app/frontend/entrypoints/application.js、创建 app/frontend/pages、配置 config/initializers/inertia_rails.rb、在 ApplicationController 中设置 inertia_share,并用 render inertia: 渲染页面。开发时分别运行 bin/rails server 与 bin/vite dev。

适用场景:需要以 Rails 为后端、前端使用 React/Vue/Svelte 的单页式应用,或希望复用带认证与 UI 组件的启动套件。

限制:资料未提供收费、价格、平台与效果信息。升级到 Inertia.js v3 需添加 use_script_element_for_initial_page、use_data_inertia_head_attribute、always_include_errors_hash 配置,并注意 React 19+、Svelte 5+、ES2022、ESM-only、移除 Axios 等破坏性变更。配置项与排错说明以资料为准。