11# Migration Guide: ActiveAdmin Tom Select (Tailwind v4)
22
3- This guide helps you migrate from ` activeadmin-searchable_select ` to ` activeadmin-tom_select ` on ActiveAdmin 4.0.0.beta19 with Tailwind CSS v4.
3+ This guide helps you migrate from ` activeadmin-searchable_select ` to ` activeadmin-tom_select ` on ActiveAdmin 4.0.0.beta20 with Tailwind CSS v4.
44
55## Quick Start (New Installation)
66
@@ -15,9 +15,10 @@ npm install activeadmin-tom_select tom-select
1515## Why Update?
1616
1717- Tom Select replaces Select2 (no jQuery)
18- - ActiveAdmin 4.0.0.beta19 compatible
18+ - ActiveAdmin 4.0.0.beta20 compatible (requires Rails 7.2+)
1919- Tailwind CSS v4 styles included
2020- Auto-init helpers for searchable selects
21+ - Ruby 3.2+ and 4.0 compatible
2122
2223## 1. Update Gemfile
2324
@@ -48,7 +49,7 @@ import { setupAutoInit } from "activeadmin-tom_select";
4849setupAutoInit ();
4950```
5051
51- ## 4. Tailwind CSS Build (ActiveAdmin 4.0.0.beta19 )
52+ ## 4. Tailwind CSS Build (ActiveAdmin 4.0.0.beta20 )
5253
5354### 4.1 Tailwind Input
5455
@@ -177,13 +178,25 @@ end
177178- Ensure ` window.TomSelect ` is set.
178179- Ensure ` setupAutoInit() ` runs.
179180
180- ## ActiveAdmin 4.0.0.beta19 Notes (from upgrade guide)
181+ ## ActiveAdmin 4.0.0.beta20 Notes (from upgrade guide)
181182
183+ ** Version Requirements:**
184+ - Rails 7.2+ (Rails 7.0 and 7.1 are no longer supported)
185+ - Ruby 3.2+ (Ruby 3.0 and 3.1 are no longer supported)
186+
187+ ** Breaking Changes from earlier v4 betas:**
182188- ` _site_header.html.erb ` container class changed from ` sticky ` to ` fixed ` .
183189- ` active_admin.html.erb ` adds the ` pt-16 ` utility class.
184190- Tailwind v4 requires ` @import "tailwindcss" ` + ` @config ` .
185- - jQuery and jQuery UI removed; ` columns ` and ` tabs ` removed.
191+ - jQuery and jQuery UI removed; ` columns ` and ` tabs ` components removed.
186192- Replace ` default_main_content ` with ` render "show_default" ` .
187193- Replace ` as: :datepicker ` with ` as: :date_picker ` .
188194- Replace ` active_admin_comments ` with ` active_admin_comments_for(resource) ` .
189195- Replace ` attributes_table ` with ` attributes_table_for(resource) ` in sidebars.
196+
197+ ** New in beta20:**
198+ - Parent menu item linking support
199+ - Improved comments pagination styling
200+ - Better vertical spacing for has-many forms
201+ - Pointer cursor restored on eligible buttons
202+ - Various accessibility improvements
0 commit comments