@betterstart/cli 0.1.3 → 0.1.5

package/templates/schema.json

@@ -0,0 +1,959 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://betterstart.dev/schemas/schema.json",
+  "title": "BetterStart Schema Definition",
+  "description": "JSON Schema for validating custom schema files (courses.json, testimonials.json, instructors.json, events.json, etc.)",
+  "type": "object",
+  "required": ["name", "label", "fields"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference (typically './schema.json')"
+    },
+    "name": {
+      "type": "string",
+      "description": "Unique identifier for the schema (e.g., 'courses', 'site-settings')",
+      "pattern": "^[a-z][a-zA-Z0-9-]*$"
+    },
+    "label": {
+      "type": "string",
+      "description": "Human-readable display name for the schema"
+    },
+    "description": {
+      "type": "string",
+      "description": "Brief description of what this schema represents"
+    },
+    "icon": {
+      "type": "string",
+      "description": "Icon name from the icon library (e.g., 'BookOpen', 'Package')"
+    },
+    "type": {
+      "type": "string",
+      "description": "Schema type: 'entity' for CRUD list (default), 'single' for singleton record (site settings, about page), 'github' for GitHub-synced content",
+      "enum": ["entity", "single", "github"]
+    },
+    "username": {
+      "type": "string",
+      "description": "GitHub username or organization for GitHub-type schemas"
+    },
+    "repos": {
+      "type": "array",
+      "description": "GitHub repository configurations for syncing content",
+      "items": {
+        "$ref": "#/$defs/repoConfig"
+      }
+    },
+    "fields": {
+      "type": "array",
+      "description": "Array of field definitions",
+      "items": {
+        "$ref": "#/$defs/field"
+      },
+      "minItems": 1
+    },
+    "columns": {
+      "type": "array",
+      "description": "Table column definitions for list views",
+      "items": {
+        "$ref": "#/$defs/column"
+      }
+    },
+    "actions": {
+      "$ref": "#/$defs/actions"
+    },
+    "search": {
+      "$ref": "#/$defs/search"
+    },
+    "filters": {
+      "$ref": "#/$defs/filters"
+    },
+    "autoCategorize": {
+      "$ref": "#/$defs/autoCategorize"
+    },
+    "autoSlugify": {
+      "$ref": "#/$defs/autoSlugify"
+    },
+    "githubSyncPage": {
+      "$ref": "#/$defs/githubSyncPage"
+    }
+  },
+  "$defs": {
+    "field": {
+      "type": "object",
+      "description": "A field definition",
+      "oneOf": [
+        { "$ref": "#/$defs/serialField" },
+        { "$ref": "#/$defs/stringField" },
+        { "$ref": "#/$defs/textField" },
+        { "$ref": "#/$defs/markdownField" },
+        { "$ref": "#/$defs/richtextField" },
+        { "$ref": "#/$defs/imageField" },
+        { "$ref": "#/$defs/dateField" },
+        { "$ref": "#/$defs/booleanField" },
+        { "$ref": "#/$defs/timestampField" },
+        { "$ref": "#/$defs/numberField" },
+        { "$ref": "#/$defs/decimalField" },
+        { "$ref": "#/$defs/selectField" },
+        { "$ref": "#/$defs/listField" },
+        { "$ref": "#/$defs/groupField" },
+        { "$ref": "#/$defs/tabsField" },
+        { "$ref": "#/$defs/relationshipField" },
+        { "$ref": "#/$defs/separatorField" },
+        { "$ref": "#/$defs/videoField" },
+        { "$ref": "#/$defs/mediaField" },
+        { "$ref": "#/$defs/githubRepoField" },
+        { "$ref": "#/$defs/githubBranchField" },
+        { "$ref": "#/$defs/githubDirectoryField" },
+        { "$ref": "#/$defs/githubChaptersField" },
+        { "$ref": "#/$defs/curriculumField" }
+      ]
+    },
+    "baseFieldProperties": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Field identifier (camelCase)",
+          "pattern": "^[a-zA-Z][a-zA-Z0-9]*$"
+        },
+        "label": {
+          "type": "string",
+          "description": "Human-readable field label"
+        },
+        "required": {
+          "type": "boolean",
+          "description": "Whether this field is required",
+          "default": false
+        },
+        "hint": {
+          "type": "string",
+          "description": "Helper text displayed below the field"
+        },
+        "showWhen": {
+          "$ref": "#/$defs/showWhenCondition"
+        },
+        "dependsOn": {
+          "$ref": "#/$defs/dependsOnCondition"
+        }
+      }
+    },
+    "dependsOnCondition": {
+      "type": "object",
+      "description": "For cascading fields - specifies which sibling field(s) this field depends on",
+      "additionalProperties": false,
+      "properties": {
+        "repo": {
+          "type": "string",
+          "description": "Name of the repo field for branch/directory selectors"
+        },
+        "branch": {
+          "type": "string",
+          "description": "Name of the branch field for directory selectors"
+        },
+        "directory": {
+          "type": "string",
+          "description": "Name of the directory field for chapters loader"
+        }
+      }
+    },
+    "showWhenCondition": {
+      "type": "object",
+      "description": "Conditional visibility based on sibling field value",
+      "required": ["field", "value"],
+      "additionalProperties": false,
+      "properties": {
+        "field": {
+          "type": "string",
+          "description": "Name of the sibling field to watch"
+        },
+        "value": {
+          "oneOf": [{ "type": "boolean" }, { "type": "string" }, { "type": "number" }],
+          "description": "Value that makes this field visible"
+        }
+      }
+    },
+    "serialField": {
+      "type": "object",
+      "description": "Auto-incrementing primary key field",
+      "required": ["name", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "serial" },
+        "primaryKey": {
+          "type": "boolean",
+          "description": "Whether this is the primary key",
+          "default": true
+        }
+      }
+    },
+    "stringField": {
+      "type": "object",
+      "description": "Single-line text input field",
+      "required": ["name", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "string" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "length": {
+          "type": "integer",
+          "description": "Maximum character length",
+          "minimum": 1,
+          "maximum": 65535
+        },
+        "hint": { "type": "string" },
+        "placeholder": {
+          "type": "string",
+          "description": "Placeholder text displayed in the input field"
+        },
+        "default": { "type": "string" },
+        "hasIcon": {
+          "type": "boolean",
+          "description": "Whether this field has an associated icon picker"
+        },
+        "hidden": {
+          "type": "boolean",
+          "description": "Whether this field is hidden from the form UI but still exists in the database"
+        },
+        "showWhen": { "$ref": "#/$defs/showWhenCondition" }
+      }
+    },
+    "textField": {
+      "type": "object",
+      "description": "Multi-line text area field",
+      "required": ["name", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "text" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "length": {
+          "type": "integer",
+          "description": "Maximum character length",
+          "minimum": 1
+        },
+        "hint": { "type": "string" },
+        "placeholder": {
+          "type": "string",
+          "description": "Placeholder text displayed in the text area"
+        },
+        "default": { "type": "string" },
+        "hidden": {
+          "type": "boolean",
+          "description": "Whether this field is hidden from the form UI but still exists in the database"
+        },
+        "showWhen": { "$ref": "#/$defs/showWhenCondition" }
+      }
+    },
+    "markdownField": {
+      "type": "object",
+      "description": "Rich text editor with markdown support",
+      "required": ["name", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "markdown" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "hint": { "type": "string" },
+        "placeholder": {
+          "type": "string",
+          "description": "Placeholder text displayed in the markdown editor"
+        },
+        "hidden": {
+          "type": "boolean",
+          "description": "Whether this field is hidden from the form UI but still exists in the database"
+        },
+        "showWhen": { "$ref": "#/$defs/showWhenCondition" }
+      }
+    },
+    "richtextField": {
+      "type": "object",
+      "description": "WYSIWYG rich text editor with markdown storage",
+      "required": ["name", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "richtext" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "hint": { "type": "string" },
+        "placeholder": {
+          "type": "string",
+          "description": "Placeholder text displayed in the rich text editor"
+        },
+        "hidden": {
+          "type": "boolean",
+          "description": "Whether this field is hidden from the form UI but still exists in the database"
+        },
+        "showWhen": { "$ref": "#/$defs/showWhenCondition" }
+      }
+    },
+    "imageField": {
+      "type": "object",
+      "description": "Image upload field",
+      "required": ["name", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "image" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "length": {
+          "type": "integer",
+          "description": "Maximum URL length"
+        },
+        "hint": { "type": "string" },
+        "hidden": {
+          "type": "boolean",
+          "description": "Whether this field is hidden from the form UI but still exists in the database"
+        }
+      }
+    },
+    "dateField": {
+      "type": "object",
+      "description": "Date picker field",
+      "required": ["name", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "date" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "default": { "type": "string" },
+        "hint": { "type": "string" },
+        "hidden": {
+          "type": "boolean",
+          "description": "Whether this field is hidden from the form UI but still exists in the database"
+        }
+      }
+    },
+    "booleanField": {
+      "type": "object",
+      "description": "Toggle/checkbox field",
+      "required": ["name", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "boolean" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "default": { "type": "boolean" },
+        "hint": { "type": "string" },
+        "hidden": {
+          "type": "boolean",
+          "description": "Whether this field is hidden from the form UI but still exists in the database"
+        }
+      }
+    },
+    "timestampField": {
+      "type": "object",
+      "description": "Timestamp field (typically auto-generated)",
+      "required": ["name", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "timestamp" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "hidden": {
+          "type": "boolean",
+          "description": "Whether this field is hidden from the form UI but still exists in the database"
+        }
+      }
+    },
+    "numberField": {
+      "type": "object",
+      "description": "Integer number input field",
+      "required": ["name", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "number" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "default": { "type": "integer" },
+        "hint": { "type": "string" },
+        "placeholder": {
+          "type": "string",
+          "description": "Placeholder text displayed in the number input"
+        },
+        "min": { "type": "integer" },
+        "max": { "type": "integer" },
+        "hidden": {
+          "type": "boolean",
+          "description": "Whether this field is hidden from the form UI but still exists in the database"
+        }
+      }
+    },
+    "decimalField": {
+      "type": "object",
+      "description": "Decimal number field (for prices, percentages, etc.)",
+      "required": ["name", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "decimal" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "format": {
+          "type": "string",
+          "description": "Display format",
+          "enum": ["currency", "percentage", "plain"]
+        },
+        "precision": {
+          "type": "integer",
+          "description": "Total number of digits",
+          "minimum": 1,
+          "maximum": 65
+        },
+        "scale": {
+          "type": "integer",
+          "description": "Number of decimal places",
+          "minimum": 0,
+          "maximum": 30
+        },
+        "hint": { "type": "string" },
+        "placeholder": {
+          "type": "string",
+          "description": "Placeholder text displayed in the decimal input"
+        },
+        "default": { "type": "number" },
+        "hidden": {
+          "type": "boolean",
+          "description": "Whether this field is hidden from the form UI but still exists in the database"
+        }
+      }
+    },
+    "selectField": {
+      "type": "object",
+      "description": "Dropdown select field",
+      "required": ["name", "type", "options"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "select" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "hint": { "type": "string" },
+        "options": {
+          "type": "array",
+          "description": "Available options for the select",
+          "items": {
+            "type": "object",
+            "required": ["label", "value"],
+            "additionalProperties": false,
+            "properties": {
+              "label": {
+                "type": "string",
+                "description": "Display label"
+              },
+              "value": {
+                "type": "string",
+                "description": "Value stored in database"
+              }
+            }
+          },
+          "minItems": 1
+        },
+        "default": { "type": "string" },
+        "hidden": {
+          "type": "boolean",
+          "description": "Whether this field is hidden from the form UI but still exists in the database"
+        }
+      }
+    },
+    "listField": {
+      "type": "object",
+      "description": "Repeatable list of items with nested fields",
+      "required": ["name", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "list" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "maxItems": {
+          "type": "integer",
+          "description": "Maximum number of items allowed",
+          "minimum": 1
+        },
+        "length": {
+          "type": "integer",
+          "description": "Maximum length for simple list items"
+        },
+        "hint": { "type": "string" },
+        "hidden": {
+          "type": "boolean",
+          "description": "Whether this field is hidden from the form UI but still exists in the database"
+        },
+        "showWhen": { "$ref": "#/$defs/showWhenCondition" },
+        "fields": {
+          "type": "array",
+          "description": "Nested field definitions for complex list items",
+          "items": {
+            "$ref": "#/$defs/field"
+          }
+        },
+        "items": {
+          "description": "Single field definition for simple list items",
+          "$ref": "#/$defs/simpleListItem"
+        }
+      }
+    },
+    "simpleListItem": {
+      "type": "object",
+      "description": "Simple list item definition",
+      "required": ["name", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "type": "string" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "length": { "type": "integer" }
+      }
+    },
+    "groupField": {
+      "type": "object",
+      "description": "Group of fields displayed together",
+      "required": ["name", "type", "fields"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "group" },
+        "label": { "type": "string" },
+        "columns": {
+          "type": "integer",
+          "description": "Number of columns for layout",
+          "minimum": 1,
+          "maximum": 4
+        },
+        "fields": {
+          "type": "array",
+          "description": "Nested field definitions",
+          "items": {
+            "$ref": "#/$defs/field"
+          },
+          "minItems": 1
+        }
+      }
+    },
+    "tabsField": {
+      "type": "object",
+      "description": "Tabbed interface for organizing fields",
+      "required": ["name", "type", "tabs"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "tabs" },
+        "tabs": {
+          "type": "array",
+          "description": "Tab definitions",
+          "items": {
+            "$ref": "#/$defs/tab"
+          },
+          "minItems": 1
+        }
+      }
+    },
+    "relationshipField": {
+      "type": "object",
+      "description": "Relationship field linking to another schema/entity",
+      "required": ["name", "type", "relationship"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "relationship" },
+        "relationship": {
+          "type": "string",
+          "description": "Name of the related schema/entity (e.g., 'instructors', 'courses')"
+        },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "hint": { "type": "string" },
+        "multiple": {
+          "type": "boolean",
+          "description": "Whether multiple items can be selected",
+          "default": false
+        },
+        "hidden": {
+          "type": "boolean",
+          "description": "Whether this field is hidden from the form UI but still exists in the database"
+        },
+        "showWhen": { "$ref": "#/$defs/showWhenCondition" }
+      }
+    },
+    "separatorField": {
+      "type": "object",
+      "description": "Visual separator between form fields",
+      "required": ["type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "separator" },
+        "label": {
+          "type": "string",
+          "description": "Optional label to display with the separator"
+        }
+      }
+    },
+    "videoField": {
+      "type": "object",
+      "description": "Video upload field",
+      "required": ["name", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "video" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "hint": { "type": "string" },
+        "maxSizeInMB": {
+          "type": "integer",
+          "description": "Maximum file size in megabytes",
+          "default": 100
+        },
+        "hidden": {
+          "type": "boolean",
+          "description": "Whether this field is hidden from the form UI but still exists in the database"
+        }
+      }
+    },
+    "mediaField": {
+      "type": "object",
+      "description": "Media upload field supporting both images and videos",
+      "required": ["name", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "media" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "hint": { "type": "string" },
+        "maxSizeInMB": {
+          "type": "integer",
+          "description": "Maximum file size in megabytes",
+          "default": 100
+        },
+        "hidden": {
+          "type": "boolean",
+          "description": "Whether this field is hidden from the form UI but still exists in the database"
+        }
+      }
+    },
+    "githubRepoField": {
+      "type": "object",
+      "description": "GitHub repository selection combobox field",
+      "required": ["name", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "github-repo" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "hint": { "type": "string" },
+        "showWhen": { "$ref": "#/$defs/showWhenCondition" }
+      }
+    },
+    "githubBranchField": {
+      "type": "object",
+      "description": "GitHub branch selection combobox field (depends on a repo field)",
+      "required": ["name", "type", "dependsOn"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "github-branch" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "hint": { "type": "string" },
+        "showWhen": { "$ref": "#/$defs/showWhenCondition" },
+        "dependsOn": { "$ref": "#/$defs/dependsOnCondition" }
+      }
+    },
+    "githubDirectoryField": {
+      "type": "object",
+      "description": "GitHub directory selection combobox field (depends on repo and branch fields)",
+      "required": ["name", "type", "dependsOn"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "github-directory" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "hint": { "type": "string" },
+        "showWhen": { "$ref": "#/$defs/showWhenCondition" },
+        "dependsOn": { "$ref": "#/$defs/dependsOnCondition" }
+      }
+    },
+    "githubChaptersField": {
+      "type": "object",
+      "description": "GitHub chapters loader field - loads markdown files from a directory as chapters",
+      "required": ["name", "type", "dependsOn", "fields"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "github-chapters" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "hint": { "type": "string" },
+        "showWhen": { "$ref": "#/$defs/showWhenCondition" },
+        "dependsOn": { "$ref": "#/$defs/dependsOnCondition" },
+        "fields": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/field" },
+          "description": "Fields for each chapter (title, slug, description)"
+        }
+      }
+    },
+    "curriculumField": {
+      "type": "object",
+      "description": "Curriculum editor field with sequential or weekly mode support",
+      "required": ["name", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "type": { "const": "curriculum" },
+        "label": { "type": "string" },
+        "required": { "type": "boolean" },
+        "hint": { "type": "string" },
+        "hidden": {
+          "type": "boolean",
+          "description": "Whether this field is hidden from the form UI but still exists in the database"
+        }
+      }
+    },
+    "tab": {
+      "type": "object",
+      "description": "A single tab containing fields",
+      "required": ["name", "label", "fields"],
+      "additionalProperties": false,
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Tab identifier"
+        },
+        "label": {
+          "type": "string",
+          "description": "Tab display label"
+        },
+        "fields": {
+          "type": "array",
+          "description": "Fields within this tab",
+          "items": {
+            "$ref": "#/$defs/field"
+          },
+          "minItems": 1
+        }
+      }
+    },
+    "column": {
+      "type": "object",
+      "description": "Table column definition for list views",
+      "required": ["accessorKey", "header"],
+      "additionalProperties": false,
+      "properties": {
+        "accessorKey": {
+          "type": "string",
+          "description": "Field name to access data from"
+        },
+        "header": {
+          "type": "string",
+          "description": "Column header text"
+        },
+        "type": {
+          "type": "string",
+          "description": "Column display type",
+          "enum": ["image", "text", "badge", "date", "number", "link"]
+        },
+        "sortable": {
+          "type": "boolean",
+          "description": "Whether the column is sortable",
+          "default": false
+        },
+        "format": {
+          "type": "string",
+          "description": "Display format (e.g., 'currency' for numbers)",
+          "enum": ["currency", "percentage"]
+        }
+      }
+    },
+    "actions": {
+      "type": "object",
+      "description": "CRUD action configuration",
+      "additionalProperties": false,
+      "properties": {
+        "draft": {
+          "type": "boolean",
+          "description": "Enable draft/publish workflow",
+          "default": false
+        },
+        "create": {
+          "type": "boolean",
+          "description": "Enable create action",
+          "default": true
+        },
+        "edit": {
+          "type": "boolean",
+          "description": "Enable edit action",
+          "default": true
+        },
+        "delete": {
+          "type": "boolean",
+          "description": "Enable delete action",
+          "default": true
+        }
+      }
+    },
+    "search": {
+      "type": "object",
+      "description": "Backend search configuration for admin tables",
+      "additionalProperties": false,
+      "required": ["fields"],
+      "properties": {
+        "fields": {
+          "type": "array",
+          "description": "Array of field names to search across (should be text-type columns like string, text, varchar)",
+          "items": {
+            "type": "string",
+            "description": "Field name to include in search"
+          },
+          "minItems": 1
+        }
+      }
+    },
+    "filters": {
+      "type": "array",
+      "description": "Filter configuration for admin tables",
+      "items": {
+        "$ref": "#/$defs/filter"
+      }
+    },
+    "filter": {
+      "type": "object",
+      "description": "Filter definition for admin tables",
+      "required": ["field", "label"],
+      "additionalProperties": false,
+      "properties": {
+        "field": {
+          "type": "string",
+          "description": "Field name to filter by"
+        },
+        "label": {
+          "type": "string",
+          "description": "Label for the filter dropdown"
+        },
+        "type": {
+          "type": "string",
+          "description": "Filter type",
+          "enum": ["select"],
+          "default": "select"
+        }
+      }
+    },
+    "repoConfig": {
+      "type": "object",
+      "description": "GitHub repository configuration for syncing content",
+      "required": ["path", "branch"],
+      "additionalProperties": false,
+      "properties": {
+        "path": {
+          "type": "string",
+          "description": "GitHub repository path (e.g., 'owner/repo')"
+        },
+        "branch": {
+          "type": "string",
+          "description": "Git branch to sync from"
+        },
+        "basePath": {
+          "type": "string",
+          "description": "Base path within the repository to sync files from"
+        }
+      }
+    },
+    "autoCategorize": {
+      "type": "object",
+      "description": "Auto-categorization configuration for GitHub-synced schemas",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Enable automatic categorization during GitHub sync",
+          "default": true
+        },
+        "useRepoName": {
+          "type": "boolean",
+          "description": "Automatically create/assign category based on repository name",
+          "default": true
+        },
+        "keywords": {
+          "type": "array",
+          "description": "Keyword-based categorization rules",
+          "items": {
+            "$ref": "#/$defs/categoryKeyword"
+          }
+        }
+      }
+    },
+    "categoryKeyword": {
+      "type": "object",
+      "description": "Keyword rule for auto-categorization",
+      "required": ["category", "patterns"],
+      "additionalProperties": false,
+      "properties": {
+        "category": {
+          "type": "string",
+          "description": "Category name to assign when patterns match"
+        },
+        "patterns": {
+          "type": "array",
+          "description": "Array of keywords/patterns to match against title and content",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1
+        }
+      }
+    },
+    "autoSlugify": {
+      "type": "object",
+      "description": "Auto-slugification configuration for generating URL-friendly slugs from fields",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Enable automatic slug generation",
+          "default": true
+        },
+        "sourceField": {
+          "type": "string",
+          "description": "Field to use as source for slug generation (e.g., 'name', 'title')"
+        },
+        "targetField": {
+          "type": "string",
+          "description": "Field to store the generated slug (typically 'slug')"
+        }
+      }
+    },
+    "githubSyncPage": {
+      "type": "object",
+      "description": "GitHub sync page configuration for displaying sync status and controls",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Enable GitHub sync page",
+          "default": false
+        },
+        "route": {
+          "type": "string",
+          "description": "Route path for the sync page (e.g., 'github-sync')"
+        }
+      }
+    }
+  }
+}