Custom component and settings

💬 App Building
1

Hi fellow Retoolers,

I’m using @tryretool/custom-component-support to build a Custom Component Library.

What works:

  • Using "entryPoint": "src/index.tsx" works
  • My component renders correctly
  • But "settings" are completely ignored (even though defined)

What doesn't work:

When switching to the "components" + "model" format (per Retool v2 docs), I see errors during npm run deploy like:

Cannot read properties of undefined (reading 'includes') [plugin generate-manifest]

The resulting manifest always shows "model": [], and the setting never appears in the Retool UI.

Request:

  • Is this a known limitation of retool-ccl?
  • Should "model" fields be registered automatically?
  • Is there a correct CLI version or flag I need?

By the way, the component is a fileuploader to Azure blob storage with support for file objects instead of having to deal with base64 which is heavy in client memory and cpu consumption when files are bigger than ~1gb especially...

Thanks in advance,

2

Hey @Plane

Retool's Custom Component Libraries (CCL) have limitations—settings can't be edited after creation, and model fields may not auto-register correctly. Ensure you're using Node.js v20+ and the latest Retool CLI. If issues persist, refer to Retool's GitHub examples and create the custom component according to documentation Custom Component Documentation.