Skip to content

Document SQLite-to-MySQL migration path in STUDIO.md and publishing to supported hostings - #3984

Merged
sejas merged 2 commits into
trunkfrom
document-mysql-migration-in-studio-md
Jun 29, 2026
Merged

Document SQLite-to-MySQL migration path in STUDIO.md and publishing to supported hostings#3984
sejas merged 2 commits into
trunkfrom
document-mysql-migration-in-studio-md

Conversation

@sejas

@sejas sejas commented Jun 28, 2026

Copy link
Copy Markdown
Member

Related issues

How AI was used in this PR

PR created with Claude, and tested manually.

Proposed Changes

STUDIO.md is the per-site instruction file Studio bundles into every local site and feeds to the built-in AI assistant. Two gaps in its guidance led to bad answers:

  1. Migrating to MySQL. The database section only listed SQLite limitations, with nothing about migrating out — so when a user asked how to move their site to a production host running MySQL, the assistant discouraged them with a wrong answer about compatibility issues. This adds a "Migrating to MySQL" subsection: Studio exports a MySQL-compatible database dump (studio export my-site.sql --mode db) that imports cleanly into any MySQL/MariaDB host with no migration plugin needed. The existing limitations are reframed as applying only to running on SQLite locally, not to the exported dump.

  2. Publishing to WordPress.com / Pressable. Push/pull were only present in the MCP tool table, with no CLI guidance. This adds a "Publishing to WordPress.com or Pressable" section (studio push / studio pull, sync options, overwrite and eligibility caveats), aligned with the rules the Studio Code agent already follows.

The result: the next time a user asks about migrating to MySQL or publishing to production, the assistant gives a correct, encouraging answer.

Testing Instructions

  • Read the updated "Database: SQLite (not MySQL)" and "Publishing to WordPress.com or Pressable" sections in skills/STUDIO.md.
  • Run npm start
  • Create a new site
  • Start Claude Code and ask about exporting a database or or publishing to WordPress.com

Pre-merge Checklist

  • Have you checked for TypeScript, React or other console errors? (N/A — documentation-only change)
Clarify that Studio can export a MySQL-compatible database dump, so sites
migrate cleanly to any MySQL host. Prevents the AI assistant from wrongly
warning about compatibility issues when users ask about moving to production.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@sejas sejas self-assigned this Jun 28, 2026
@sejas
sejas requested review from a team, katinthehatsite and nightnei June 28, 2026 06:49
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@sejas sejas changed the title Document SQLite-to-MySQL migration path in STUDIO.md Jun 28, 2026

@epeicher epeicher left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks Antonio for improving this! I have tested a couple of prompts using Claude Code, and the results are much better than the same prompts using trunk. While in trunk they offer no clear path forward to migate the database, these are a couple of results with these changes applied:

Migrate my site, please How can I migrate my site
Image Image

Changes LGTM!

@sejas
sejas merged commit b76bf72 into trunk Jun 29, 2026
16 of 19 checks passed
@sejas
sejas deleted the document-mysql-migration-in-studio-md branch June 29, 2026 09:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

2 participants