Filament v4 ya está oficialmente estable desde el 12 de agosto de 2025. Después de una fase beta, la comunidad y el equipo central han confirmado su disponibilidad para producción.
Novedades destacadas en Filament v4
1. Rendimiento mejorado
- Tablas grandes alcanzan hasta 3 × más velocidad, gracias a optimizaciones en Blade y reducción de vistas renderizadas.
- Render parcial disponible con métodos como
partiallyRenderComponentsAfterStateUpdated()oskipRenderAfterStateUpdated().
2. Tailwind CSS v4 y theming avanzado
- Incorporación de Tailwind v4 con sistema de color
oklch, configuraciones más flexibles y compilaciones más rápidas. - Mejor accesibilidad con encabezados semánticos dinámicos y contraste automático.
3. Autenticación reforzada (MFA)
- Soporte nativo para autenticación multifactor: apps tipo TOTP (Google Authenticator, Authy…) o código por email.
4. Recursos anidados y organización mejorada
- Ahora se pueden definir recursos “hijo” dentro de un recurso “padre” usando
--nested, lo que mejora la navegación y el orden dentro del panel. - Nueva estructura más clara con directorios dedicados para recursos, páginas, esquemas, etc.
5. Forms y Rich Editor renovados
- El editor enriquecido basado en TipTap permite:
- Almacenamiento en HTML o JSON.
- Bloques personalizados (drag & drop).
- Merge tags (p. ej.
{{ name }}) para contenido dinámico.
- Nuevos campos: slider, editor de código, table repeater.
- Hooks JavaScript (
hiddenJs(),afterStateUpdatedJs()…) para reducir peticiones al servidor.
6. Tablas con fuentes personalizadas y mejoras en UX
- Soporte para datos personalizados sin necesidad de Eloquent, ideal para APIs externas o conjuntos dinámicos.
- Mejores acciones masivas: autorización por registro, procesamiento por bloques (chunking) y agrupación de errores/éxitos.
- Filas ordenables, encabezados visibles en tabla vacía y filtros más intuitivos.
7. Mejoras en acciones, documentación, y ergonomía
- Schemas unifican formularios, infolistas, layouts y acciones bajo un mismo espacio de nombres (
Schema). - Acciones reutilizables, simplifican su uso en tablas, formularios e infolistas, con mejores importaciones.
- Optimización y reorganización de la documentación para una mejor lectura.
- Pequeños detalles útiles:
FilamentTimezone, formatos ISO,preserveFormDataWhenCreatingAnother(), enumeraciones de íconos para autocompletado, etc.
️ Puntos de ruptura al migrar desde Filament v3
Recomendamos revisar cuidadosamente estas áreas al actualizar:
- Estructura de directorios y generación de archivos: v4 introduce una arquitectura diferente y flags en
file_generationpara controlar el comportamiento. - Visibilidad de archivos y almacenamiento: el disco predeterminado cambia y la visibilidad pasa a
private, lo que puede implicar ajustes si tu app maneja archivos locales. - Filtros diferidos por defecto:
deferFilters()ahora está activado por defecto. Si prefieres el comportamiento antiguo, deberás desactivarlo. - Comportamiento de layouts y componentes (
Grid,Section,Fieldset) cambia, ya no ocupan todas las columnas por defecto. - Paginación
alldesactivada por defecto en tablas; debes reconfigurar si la necesitas. - Plugin Spatie Translatable está deprecado; se recomienda usar el fork de Lara Zeus.
- Estados de campo ahora como enums: si no los manejas adecuadamente, esto causará errores.
- Scopes de tenancy ahora automáticos en consultas y creación de registros.
- Cambio en comportamiento de radios inline y etiquetas; es posible que necesites ajustar
inlineLabel(). - Ordenamiento de tablas por clave primaria ahora predeterminado; se puede deshabilitar con
defaultKeySort(false).