withstudiocms · dreyfus92 · Feb 22, 2026 · Feb 18, 2026 · Feb 18, 2026 · Feb 18, 2026
@@ -0,0 +1,161 @@
+---
+i18nReady: true
+title: "Actualización: 0.1.0-beta.31"
+description: Actualización de StudioCMS a Beta.31
+topic: guides
+sidebar:
+  label: 0.1.0-beta.31
+  order: 999984
+---
+
+import ReadMore from '~/components/ReadMore.astro'
+import { PackageManagers } from 'starlight-package-managers'
+import { FileTree, TabItem, Tabs, Steps, Aside } from '@astrojs/starlight/components';
+
+StudioCMS `0.1.0-beta.31` introduce cambios significativos, incluyendo una nueva capa de base de datos basada en Kysely, un sistema de plugins renovado y varias nuevas características y mejoras. Esta guía te ayudará a actualizar tu proyecto existente de StudioCMS a la última versión.
+
+## Cambios importantes
+- Sistema de plugins refactorizado. Consulta la [documentación de plugins](/es/plugins/) para más detalles.
+- Implementada nueva capa de base de datos basada en Kysely.
+- Eliminado el soporte para opciones de configuración pasadas directamente a la integración de Astro de StudioCMS, ahora todas las opciones de configuración deben definirse en el archivo `studiocms.config.mjs`. Consulta la [Referencia de Configuración](/es/start-here/configuration/) para más detalles.
+
+## Nuevas funcionalidades
+- Implementado nuevo comando [`studiocms migrate`](/es/how-it-works/cli/#migrate) para manejar las migraciones de base de datos.
+- Permitir deshabilitar las etiquetas meta del generador mediante la opción de configuración [`features.dashboard.security.hideGeneratorTags`](/es/config-reference/features/#hidegeneratortags).
+- StudioCMS ahora soporta diferentes dialectos de base de datos mediante [Kysely](https://kysely.dev/).
+- Introducida nueva middleware para mostrar errores del sistema en páginas con errores en lugar de hacer que todo el sitio se bloquee.
+- Nuevas características de plugins:
+  - Inyección dinámica de componentes y scripts en el panel de control a través de nuevos hooks de plugins.
+  - Nuevos ayudantes de base de datos para facilitar el acceso a la base de datos dentro de los plugins.
+- Introducida nueva página del panel de control para gestionar el sistema.
+  - Incluye un panel de información del sistema (debug).
+  - Proporciona acceso rápido a tus tablas de base de datos mientras estás en producción.
+- Agregada la nueva aplicación de barra de herramientas de desarrollador integrada en StudioCMS para ver y gestionar tu base de datos mientras estás en modo de desarrollo.
+- Integrada rastreo web-vitals/analytics opcional al panel de control para obtener mejores insights de rendimiento.
+  - Esto puede activarse mediante la opción de configuración [`features.webVitals`](/es/config-reference/features/#webvitals).
+  - Para quienes anteriormente usaban las integraciones `@studiocms/web-vitals` o `@astrojs/web-vitals`, esto ahora está integrado y puede configurarse mediante la configuración de StudioCMS.
+- Agregado nuevo comando CLI [`studiocms debug`](/es/how-it-works/cli/#debug) para acceder rápidamente a información útil de depuración sobre tu proyecto StudioCMS.
+
+## Correcciones de errores y mejoras
+- Actualizada la URL de la imagen del usuario fantasma.
+- Refactorizada la generación de `urlRoute` de los datos de la página para resolver correctamente.
+- Refactorizados y simplificados los componentes de diseño del panel de control.
+- Mejorados los tipos de configuración de StudioCMS y los comentarios de JSDoc.
+- Refactorizados los comandos CLI para usar la nueva capa de base de datos.
+- Introducidas nuevas utilidades de depuración para facilitar el acceso a información útil de depuración.
+
+## Instrucciones para la migración
+
+Para actualizar tu proyecto StudioCMS a la versión `0.1.0-beta.31`, sigue estos pasos:
+
+<Steps>
+
+1. **Actualiza tus dependencias de StudioCMS** a la última versión:
+   <PackageManagers pkg="@studiocms/upgrade" type='dlx' />
+
+2. **Si tienes plugins personalizados**, asegúrate de que estén actualizados para ser compatibles con el nuevo sistema de plugins. Consulta la [documentación de plugins](/es/plugins/) para obtener orientación.
+
+3. **Revisa tu archivo `studiocms.config.mjs`** para asegurarte de que todas las opciones de configuración estén correctamente establecidas según el nuevo esquema. Consulta la [Referencia de Configuración](/es/start-here/configuration/) para obtener detalles.
+
+   - **¿Anteriormente usaste las integraciones `@studiocms/web-vitals` o `@astrojs/web-vitals`?** Elimínalas de las dependencias de tu proyecto y configura el rastreo web vitals integrado a través de la opción `features.webVitals` en tu archivo `studiocms.config.mjs`:
+      ```ts {3} title="studiocms.config.mjs"
+      export default defineStudioCMSConfig({
+        features: {
+          webVitals: true,
+        },
+      });
+      ```
+
+4. **Configura una nueva conexión de base de datos para la nueva capa de base de datos basada en Kysely.** Actualiza tu archivo `.env` con los detalles de conexión de base de datos necesarios. Mantén tu base de datos anterior intacta para la migración.
+
+   <ReadMore>Ir a [Prepara tu base de datos](/es/start-here/getting-started/#prepara-tu-base-de-datos) para más información sobre configurar tu base de datos.</ReadMore>
+   <ReadMore>Ir a [Variables de entorno](/es/start-here/environment-variables/) para más información sobre configurar tus variables de entorno.</ReadMore>
+
+5. **Configura tu dialecto de base de datos en `studiocms.config.mjs` bajo la opción `db`. Por ejemplo, para usar libSQL:**
+
+   ```ts {3} title="studiocms.config.mjs"
+   export default defineStudioCMSConfig({
+     db: {
+       dialect: 'libsql', // o 'postgresql', 'mysql'
+     },
+   });
+   ```
+
+   <Aside type="note" title="Lenguajes de bases de datos">
+    StudioCMS ahora soporta múltiples lenguajes de base de datos a través de Kysely. Asegúrate de configurar el lenguaje correcto para tu base de datos. Por defecto se usará `libsql` si no se especifica ningún lenguaje.
+   </Aside>
+
+6. **Instala los paquetes de clientes de base de datos necesarios** para tu lenguaje de base de datos elegido:
+
+   <Tabs syncKey='db-setup-method'>
+
+   <TabItem label="libSQL (default)" icon="database">
+     <PackageManagers type='add' pkg="@libsql/client @libsql/kysely-libsql" />
+   </TabItem>
+
+   <TabItem label="MySQL" icon="database">
+     <PackageManagers type='add' pkg="mysql2" />
+   </TabItem>
+
+   <TabItem label="PostgreSQL" icon="database">
+     <PackageManagers type='add' pkg="pg" />
+   </TabItem>
+
+   </Tabs>
+
+7. **Descarga la herramienta de migración en la raíz de tu proyecto StudioCMS:**
+
+   <PackageManagers pkg="@studiocms/migrator" type='add' />
+
+   Esta herramienta leerá tu `studiocms.config.mjs` para hacer posible la conexión con el correspondiente lenguaje de tu base de datos.
+
+8. **Ejecución de esquema de migración:**
+
+   Dado que la capa de base de datos ha cambiado, deberás ejecutar migraciones para actualizar el esquema de tu base de datos y que sea compatible con la nueva versión. Hay dos formas de hacerlo:
+
+   <Tabs>
+   <TabItem label="Usando la CLI de StudioCMS">
+
+   Integrado en la CLI de StudioCMS hay un nuevo comando `migrate` que ejecutará las migraciones necesarias por ti. Para usarlo, ejecuta el siguiente comando en el directorio de tu proyecto:
+
+   <PackageManagers type="exec" args="studiocms migrate" />
+
+   Se te pedirá que selecciones una opción para migrar el esquema de tu base de datos a la última versión, retroceder a una versión anterior o ver el estado actual de la migración. Selecciona « Migrate to Latest » (Migrar a la última versión) para actualizar el esquema de tu base de datos.
+
+   <Aside type="note" title="Estado de migración y opciones">
+    Siempre puedes verificar el estado de tus migraciones ejecutando `studiocms migrate --status` para ver qué migraciones se han aplicado y cuáles están pendientes.
+
+    También puedes usar la opción `--latest` o `-l` para migrar automáticamente a la última versión sin indicaciones, o usar `--rollback` o `-r` para retroceder a una versión anterior.
+   </Aside>
+
+   </TabItem>
+   <TabItem label="Usando la herramienta de migración">
+
+    Alternativamente, puedes usar la herramienta de migración que instalaste en el paso anterior. Para hacer esto, continúa con el siguiente paso y utiliza la interfaz web para ejecutar las migraciones.
+
+   </TabItem>
+   </Tabs>
+
+9. **Ejecutar la interfaz web de la herramienta de migración:**
+
+   Inicia la herramienta de migración ejecutando el siguiente comando en el directorio de tu proyecto:
+
+   <PackageManagers type="exec" args="studiocms-migrator" />
+
+   Esto iniciará un servidor web local. Abre tu navegador y navega a `http://localhost:4321` para acceder a la interfaz de la herramienta de migración.
+
+   Esta interfaz te dará opciones para migrar el esquema de tu base de datos, así como para migrar tus datos desde tu base de datos anterior a la nueva.
+
+10. Una vez que la migración esté completa, **inicia tu proyecto de StudioCMS** como de costumbre:
+
+    <PackageManagers type="run" args="dev" />
+
+    Tu proyecto debería estar funcionando ahora con el esquema de base de datos y configuración actualizados.
+</Steps>
+
+## Notas finales
+
+- Asegúrate de tener copias de seguridad de tu base de datos antes de realizar migraciones.
+- Prueba tu aplicación a fondo después de la migración para detectar cualquier problema temprano.
+- Consulta la [documentación de StudioCMS](/es/start-here/getting-started/) para obtener más información sobre nuevas funciones y cambios.
+- Si encuentras algún problema durante el proceso de migración, comunícate con nuestra [comunidad de Discord](https://chat.studiocms.dev) o abre un issue en nuestro [repositorio de GitHub](https://github.com/withstudiocms/studiocms/issues).
@@ -0,0 +1,57 @@
+---
+i18nReady: true
+title: "Actualización: v0.1.0"
+description: Actualización de StudioCMS a v0.1.0
+topic: guides
+sidebar:
+  label: v0.1.0
+  order: 999983
+---
+
+import ReadMore from '~/components/ReadMore.astro'
+import { PackageManagers } from 'starlight-package-managers'
+import { FileTree, TabItem, Tabs, Steps, Aside } from '@astrojs/starlight/components';
+
+StudioCMS `0.1.0` introduce muchos cambios importantes, nuevas funcionalidades y arreglos de errores. Esta guía te ayudará a navegar el proceso de actualización sin problemas.
+
+## Cambios importantes
+- Reemplazado `@libsql/kysely-libsql` con `kysely-turso` para el cliente de base de datos Turso. Si estabas usando `@libsql/kysely-libsql` en tu proyecto, por favor actualiza tus dependencias para usar `kysely-turso` en su lugar.
+  - **Pasos para migrar:**
+  <Steps>
+  1. Elimina `@libsql/kysely-libsql` de tus dependencias en `package.json`.
+
+     <PackageManagers type="remove" pkg="@libsql/kysely-libsql" />
+
+  2. Instala `kysely-turso` ejecutando:
+
+     <PackageManagers type="add" pkg="kysely-turso" />
+  </Steps>
+- Elimina la variable de configuración del sitio obsoleta `hideDefaultIndex` del SDK y actualiza todas las instancias de uso en StudioCMS.
+  - Nota para cualquiera que anteriormente dependiera de esta función, ahora ha sido completamente eliminada. Los usuarios deberán ajustar cualquier código que dependa de esta funcionalidad.
+- Migra las importaciones de tablas al nuevo export `@withstudiocms/sdk/tables`, y actualiza las importaciones relevantes.
+- Migra el sistema de migración al SDK de StudioCMS y actualiza las importaciones para Migrator a `@withstudiocms/sdk/migrator`.
+
+## Nuevas funcionalidades
+- Agregada nueva API de almacenamiento para archivos y activos de StudioCMS.
+  - Esta nueva API proporciona una forma estandarizada de gestionar archivos y activos dentro de StudioCMS, permitiendo una mejor integración con varios backends de almacenamiento.
+  - Consulta la [Documentación de la API de Almacenamiento](/es/storage-api/) para obtener más detalles sobre cómo usar la nueva API de Almacenamiento en tus proyectos.
+- Implementa un nuevo sistema de renderizado FolderTree y actualiza la barra lateral interna de gestión de contenido
+- Implementa la gestión de taxonomías en el panel de control de StudioCMS
+  - Agrega soporte de taxonomía para REST API y SDK
+  - Agrega UI de gestión de taxonomía en el panel de control de StudioCMS
+- Implementa nueva UI de registro de componentes para páginas de edición de contenido y gestión del sistema.
+- Arregla el problema con la información de depuración que tenía salidas no disponibles durante PROD
+
+## Reparación de errores y mejoras
+- Reestructura los tipos de tablas para alinearlos mejor con los esquemas de tablas reales y mejorar la seguridad de tipos en todo el SDK.
+- Mejora el manejo de errores y el registro para las operaciones de base de datos para ayudar en la depuración y el mantenimiento.
+- Arregla varios problemas de CSS en todas las páginas del panel de control y de autenticación.
+- Asegura que el elemento personalizado DB Studio esté definido si no está presente la barra de herramientas de desarrollo
+- Reestructura la CLI para corregir el manejo de código asíncrono/síncrono para el comando `studiocms users`
+- Reemplaza todas las instancias de `.returning()`/`returningAll()` con transacciones para soportar adecuadamente los dialectos SQL que no soportan retornar como MySQL
+
+**Lectura adicional**
+
+<ReadMore>
+  Para una lista completa de cambios en esta versión, por favor consulta el [Changelog](/es/guides/upgrade/release-notes/#010-beta32).
+</ReadMore>
@@ -0,0 +1,25 @@
+---
+i18nReady: true
+title: "Actualización: v0.2.0"
+description: Actualización StudioCMS a v0.2.0
+topic: guides
+sidebar:
+  label: v0.2.0
+  order: 999982
+---
+
+import QuickUpdate from '~/components/QuickUpdate.astro'
+
+<QuickUpdate />
+
+## Cambios importantes
+
+Ninguno. Esta es una versión sin cambios importantes.
+
+## Reparación de errores y mejoras
+
+- Migración al paquete cli-kit actualizado para mejorar la funcionalidad de la CLI.
+- Agregada expresión regular y manejo de errores adecuado para evitar que se usen caracteres ilegales (no seguros para URL) para objetos S3.
+- Se corrigió un problema donde guardar una página que no tiene `draft` establecido en `true`, anteriormente actualizaba el valor de la fecha `publishedAt`.
+- Se reestructuraron las verificaciones de permisos para las rutas del panel de control a nivel de middleware para evitar el acceso no autorizado.
+- Se actualizaron varias dependencias a sus últimas versiones para garantizar la seguridad y estabilidad.
@@ -0,0 +1,32 @@
+---
+i18nReady: true
+title: "Actualización: v0.3.0"
+description: Actualización StudioCMS a v0.3.0
+topic: guides
+sidebar:
+  label: v0.3.0
+  badge:
+    text: NEW
+    variant: success
+  order: 999981
+---
+
+import QuickUpdate from '~/components/QuickUpdate.astro'
+
+<QuickUpdate />
+
+## Cambios importantes
+
+- Elimina los siguientes módulos virtuales obsoletos y no utilizados.
+  - `studiocms:astro-config/adapter`
+  - `studiocms:auth/utils/getLabelForPermissionLevel`
+  - `virtual:studiocms/sdk/env`
+
+## Reparación de errores y mejoras
+
+- Reemplaza `chalk` con `styleText` de `node:util` para StudioCMS CLI.
+- Actualiza las dependencias de StudioCMS.
+- Corrige el problema con `pg` y `mysql2` que requerían ser instalados cuando deberían ser opcionales.
+- Corrige la expresión regular del cliente en el frontend para permitir barras dentro de un slug, pero no fuera de este. Esto desbloquea la creación de páginas bajo sub-rutas usando solo el slug (por ejemplo, `docs/getting-started`) y solo afecta la validación del lado del cliente.
+- Elimina el código de verificación de dominio de correo electrónico heredado.
+- Corrige la renderización de la ruta 404 predeterminada.