Skip to main content
Settings.defineWorkspacePage() defines the page where workspace admins configure your app’s settings. It takes the settings schema and a render callback.

File location

The page must be the default export of a file in src/app/settings/, conventionally src/app/settings/page.tsx, so the CLI can discover it.

Example

src/app/settings/page.tsx
Inside the callback, call Settings.useForm with the same schema to get form components typed against it.

Arguments

WorkspaceSettingsSchema
required
The schema built with Settings.defineWorkspaceSchema, imported from your schema file.
() => React.ReactNode
required
A render callback returning the settings form. Use Settings.useForm inside it, and wrap the inputs in the <Form> component it returns.