Deploy a self-hosted Studio

This page is for teams that self-host Studio. The desktop and web app need no deployment at all.

A self-hosted Studio in production needs both a deployed schema and a hosted application. Start from a working framework quickstart and use a development project to rehearse changes.

Prepare the application

• Keep the intended projectIds and basename explicit on FlexkitStudio, and the matching projectId in flexkit.config.ts.
• Install @flexkit/studio and @flexkit/schema and import @flexkit/studio/styles.css once.
• Deploy the framework server handler alongside the Studio pages; static files alone are insufficient.
• Keep tokens and tool signing secrets in the server environment, outside public client variables.
• Configure the actual production origin and routing, including deep Studio links.

Deploy and verify

1. Validate a data export before a schema change that could remove or transform data.
2. Deploy the schema with the CLI and inspect completion. Studio renders the deployed schema, so this step, not the application build, is what changes what Studio users see.
3. Build and deploy the application with its framework hosting workflow.
4. Open the hosted URL in a fresh session and sign in.
5. Check Desk data, a bounded Explorer query, styles, deep links, and access restrictions.
6. If using custom tools, configure the production URL, sync, and verify a harmless invocation.

Recovery boundaries

Rolling back application code restores that application’s previous behavior; it does not reverse a backend schema change or an external tool side effect. Follow schema migration guidance and inspect actual state before retrying work.

Use Logs, Run History, and the project restriction banner to choose a recovery path. Keep the application and schema versions aligned during an upgrade.