diff --git a/extend/component/ui-options/configuration-schema.md b/extend/component/ui-options/configuration-schema.md index f3e9460c..cdff0d49 100644 --- a/extend/component/ui-options/configuration-schema.md +++ b/extend/component/ui-options/configuration-schema.md @@ -75,6 +75,43 @@ The following `options` keys can be used in property definitions: | `options.disable_array_delete` | Disable removing items from arrays | | `options.disable_array_reorder` | Disable reordering items in arrays | +## Developing and Previewing Schemas + +When building or iterating on a configuration schema, you need a way to see how your JSON schema renders as a form. +The recommended approach is to use the **live schema editor built into the Keboola UI**. + +### Live Schema Editor in Keboola UI (Recommended) + +The Keboola UI includes a built-in live schema editor that lets you edit a JSON schema and immediately see the rendered form +side by side. This is the fastest way to iterate on your schema during development. + +**How to use it:** + +1. Open any component configuration page in the Keboola UI (e.g., `https://connection.keboola.com/admin/projects//components//`). +2. Press **Ctrl+D** (or **Alt+D** / **Option+D** on Mac) while on the configuration page. +3. Use the **arrow button** in the panel toolbar to move the editor to the left or right side of the screen. +4. Click the **checkmark button** to apply the schema override for the current browser session. +5. Press **Ctrl+D** again (or click the **close button**) to hide the editor. + +This editor uses the same [RJSF](https://rjsf-team.github.io/react-jsonschema-form/) rendering library as the production UI, +so what you see in the editor is exactly what end users will see. The override is local to your browser session — it does not +change the schema registered in the Developer Portal. + +### Generating Schemas with AI Kit + +You can also use the **build-component-ui** skill from the +[Keboola AI Kit](https://github.com/keboola/ai-kit/tree/main/plugins/component-developer/skills/build-component-ui) +to generate or refine configuration schemas using AI. The skill is an expert agent specialized in: + +- Designing `configSchema.json` and `configRowSchema.json` structures +- Using `options.dependencies` for conditional field visibility +- Choosing the right UI elements and formats +- Setting up sync actions for dynamic dropdowns and test connection buttons + +To use it, install the [Keboola AI Kit](https://github.com/keboola/ai-kit) as a Claude Code plugin and invoke the +`@build-component-ui` agent. Describe your component's configuration needs and it will produce a complete schema +following Keboola conventions and best practices. + ### Example Let's assume your component accepts the following configuration: