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

• 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.

     npm

     npm uninstall @libsql/kysely-libsql

     pnpm

     pnpm remove @libsql/kysely-libsql

     yarn

     yarn remove @libsql/kysely-libsql

  2. Install kysely-turso by running:

     npm

     npm i kysely-turso

     pnpm

     pnpm add kysely-turso

     yarn

     yarn add 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

• 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

• 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.