Solución para el error de ChakraProvider _config en React 19 y Chakra UI
Introducción
Al intentar renderizar un botón tras integrar Chakra UI, puede aparecer un fallo en tiempo de ejecución que detiene la app. A continuación sintetizo la causa y cómo resolverlo paso a paso, además de compartir recomendaciones de compatibilidad para React 19.
Problema
Al mostrar un Button justo después de introducir Chakra UI, aparece un TypeError que hace referencia a la lectura de _config dentro de ChakraProvider. Este comportamiento suele deberse a una incompatibilidad entre las versiones de React, Chakra UI y sus dependencias base como Emotion y Framer Motion.
Solución recomendada
La forma más estable es alinear versiones compatibles. Tienes dos rutas posibles según tu objetivo de versión de React.
Ruta A. Configuración estable con React 18 y Chakra UI v2
1. Desinstala dependencias existentes para evitar arrastrar versiones en conflicto
npm uninstall react react-dom @chakra-ui/react @emotion/react @emotion/styled framer-motion
2. Instala React 18
npm install react@18 react-dom@18
3. Instala Chakra UI v2 y dependencias requeridas alineadas
npm install @chakra-ui/react@2 @emotion/react@11 @emotion/styled@11 framer-motion@10
4. Configura el punto de entrada main.tsx
Envuélvelo con ChakraProvider dentro de StrictMode y monta la app con createRoot de react-dom/client. Asegúrate de importar ChakraProvider desde el paquete de Chakra UI y de que el contenedor root exista en el HTML.
5. Verifica App.tsx
Importa Button desde el paquete de Chakra UI y úsalo en el JSX. Por ejemplo, renderiza un Button con la propiedad colorScheme en teal para confirmar que todo funciona.
Ruta B. React 19 con Chakra UI
Si necesitas React 19, instala la versión de Chakra UI y dependencias que declaren soporte explícito para esta versión. Recomendaciones
- Consulta siempre la matriz de compatibilidad oficial de Chakra UI y revisa las versiones mínimas de Emotion y Framer Motion.
- Elimina node_modules y el archivo de bloqueo del gestor de paquetes antes de reinstalar para evitar resoluciones antiguas.
- Asegúrate de no mezclar varios mayores de React o Chakra UI en el mismo proyecto.
Resumen
El error de _config en ChakraProvider aparece por incompatibilidad de versiones. La solución pasa por alinear React, Chakra UI, Emotion y Framer Motion. Una configuración probada es React 18 con Chakra UI v2 y Emotion 11. Si trabajas con React 19, utiliza la versión de Chakra UI compatible según la documentación y reinstala dependencias desde cero.
Cómo te ayuda Q2BSTUDIO
En Q2BSTUDIO somos una empresa de desarrollo de software y aplicaciones a medida, con prácticas de arquitectura modernas, automatización de pipelines y observabilidad para entregar proyectos robustos y eficientes. Si buscas un partner para construir software a medida y optimizar tu stack frontend y backend, visita nuestra página de aplicaciones a medida y software a medida. Además, contamos con un equipo experto en inteligencia artificial, ia para empresas, agentes IA, servicios cloud aws y azure, ciberseguridad, servicios inteligencia de negocio y power bi para impulsar tu toma de decisiones y la seguridad de tus plataformas. Descubre cómo aplicamos IA de forma práctica en tu organización en nuestra área de inteligencia artificial.
Palabras clave para tu proyecto
aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA, power bi