Skip to content
StudioCMS Docs
Main Site

Upgrade: v0.1.0

StudioCMS 0.1.0 introduces several breaking changes, new features, and bug fixes. This guide will help you navigate the upgrade process smoothly.

Breaking changes

Section titled “Breaking changes”
  • Replaced @libsql/kysely-libsql with kysely-turso for Turso database client. If you were using @libsql/kysely-libsql in your project, please update your dependencies to use kysely-turso instead.
    • Steps to migrate:

    1. Remove @libsql/kysely-libsql from your package.json dependencies.

      Terminal window
      npm uninstall @libsql/kysely-libsql

    2. Install kysely-turso by running:

      Terminal window
      npm i kysely-turso
  • Removes deprecated hideDefaultIndex site config variable from SDK and updates all instances of usage in StudioCMS.
    • Note for anyone previously relying on this feature, it has now been completely removed. Users will need to adjust any code relying on this functionality.
  • Migrates table imports to new @withstudiocms/sdk/tables export, and updated relevant imports.
  • Migrates migration system to StudioCMS SDK and updated imports for Migrator to @withstudiocms/sdk/migrator.

New Features

Section titled “New Features”
  • Added new Storage API for StudioCMS files and Assets.
    • This new API provides a standardized way to manage files and assets within StudioCMS, allowing for better integration with various storage backends.
    • Check out the Storage API Documentation for more details on how to use the new Storage API in your projects.
  • Implements new FolderTree rendering system and updated content management inner sidebar
  • Implements taxonomy management in the StudioCMS dashboard
    • Adds Taxonomy support for REST API and SDK
    • Adds Taxonomy management UI in the StudioCMS Dashboard
  • Implements new component registry UI for content editing and System management pages.
  • Fixes issue with debug info having Unavailable outputs during PROD

Bug Fixes & Improvements

Section titled “Bug Fixes & Improvements”
  • Reworks table types to better align with actual table schemas and improve type safety across the SDK.
  • Improves error handling and logging for database operations to aid in debugging and maintenance.
  • Fixes various CSS issues across all dashboard and auth pages.
  • Ensures DB Studio custom element is defined if dev-toolbar is not present
  • Reworks CLI to fix async/sync code handling for studiocms users command
  • Replaced all instances of .returning()/returningAll() with transactions to properly support SQL dialects that do not support returning such as MySQL

Further Reading

For a full list of changes in this release, please refer to the Changelog.