Plugin Kinds

Every plugin published to Tabularium declares a kind. On top of the core manifest fields, each kind defines its own extension fields. This page is generated from the live registry configuration, so it lists exactly the kinds the registry currently accepts.

Drivers (`driver`)

Database driver plugins that extend Tabularis to talk to new data stores via JSON-RPC over STDIO — any language, any database.

Browse published drivers in the registry catalogue.

Extensions

Field	Type	Required	Description
`engine`	`string`	✅	Concrete database this driver connects to (e.g. "firestore", "postgres", "qdrant"). Tabularis groups the connection catalogue by engine: every driver targeting the same database shares one engine value, so two "firestore" drivers collapse into a single Firestore entry and the user picks which driver.
`paradigms`	`array<string>`	✅	Data-model families the engine supports, most representative first. Single-model drivers declare one (e.g. ["sql"]); multi-model declare several (SurrealDB: ["document","graph","relational","key-value","vector"]). The first entry is the primary model used to place the engine in the catalogue; every entry feeds the filter chips, so a multi-model engine appears when ANY of its models is selected. Allowed values come from the registry's admin-managed paradigm list (facets), not a fixed enum, so new models never need a schema release.
`color`	`string`	—	Hex accent colour shown on the catalogue card and sidebar (e.g. "#f97316").
`default_port`	`integer`	—	Default TCP port pre-filled in the connection modal. Omit for file-, folder-, and API-based drivers.
`default_username`	`string`	—	Default username pre-filled in the connection modal (e.g. "postgres", "root").
`is_builtin`	`boolean`	—	True for drivers shipped with Tabularis. External plugins should omit this or leave it false.
`executable`	`string`	✅	Relative path to the plugin executable inside the plugin folder. No extension on Linux/macOS; Tabularis appends .exe on Windows automatically.
`interpreter`	`string`	—	Optional interpreter for script-based plugins (e.g. "python3", "node"). Omit for native binaries.
`capabilities`	`object`	✅	Feature flags that control which UI elements Tabularis renders for this driver.
`settings`	`array<object>`	—	Optional list of configuration fields the plugin exposes to the user via the Tabularis settings modal.
`data_types`	`array<object>`	—	List of data types this driver supports for column creation in the UI.
`supports_ssl`	`boolean`	—	true to show the SSL/TLS configuration tab (mode + CA/client cert/key) in the connection modal for this network driver. Defaults to false.
`ui_extensions`	`array<object>`	—	UI extension contributions rendered into named slots of the Tabularis interface. Only needed by plugins that ship a frontend module; driver-only plugins omit it.
`type_mappings`	`object`	—	Optional map of generic inferred type names to driver-native types, resolved by the host during paste/import (map_inferred_type). Keys are uppercase generic names (e.g. DATETIME, JSON); values are the driver-native equivalents (e.g. TIMESTAMP, JSONB). Lookup is case-insensitive; unmapped types pass through unchanged.
`explain_parsers`	`array<object>`	—	Plugin-owned raw EXPLAIN parser IIFE bundles loaded by Tabularis when the plugin is enabled.
`connection_metadata`	`boolean`	—	Opt in to get_connection_metadata, which returns connection-specific capabilities, data_types and type_mappings. Static manifest values remain the fallback.

Example (YAML)

name: tabularis-clickhouse-driver
description: Connect Tabularis to ClickHouse over JSON-RPC with full DDL, query, and ER-diagram support.
category: integration
kind: driver
tags:
  - clickhouse
  - analytics
  - olap
license: MIT
icon: https://raw.githubusercontent.com/example/tabularis-clickhouse/main/assets/icon.svg
homepage: https://github.com/example/tabularis-clickhouse
documentation_url: https://github.com/example/tabularis-clickhouse#readme
support:
  email: maintainers@example.com
  issues_url: https://github.com/example/tabularis-clickhouse/issues
screenshots:
  - url: https://raw.githubusercontent.com/example/tabularis-clickhouse/main/assets/screen-connect.png
    caption: Connection form with native ClickHouse fields
    alt: Tabularis connection dialog showing host, port, user, and database fields
  - url: https://raw.githubusercontent.com/example/tabularis-clickhouse/main/assets/screen-query.png
    caption: Running a SELECT against the ontime table
    alt: Tabularis data grid showing ClickHouse query results
min_runtime_version: 0.9.13
readme: |
  # ClickHouse driver for Tabularis

  Adds a native ClickHouse connection to Tabularis. Supports SELECT/INSERT/UPDATE/DELETE through execute_query, schema introspection for the explorer, DDL generation (CREATE TABLE, ALTER TABLE, DROP), and ER-diagram rendering via get_relationships.

Example (JSON)

{
  "name": "tabularis-clickhouse-driver",
  "description": "Connect Tabularis to ClickHouse over JSON-RPC with full DDL, query, and ER-diagram support.",
  "category": "integration",
  "kind": "driver",
  "tags": [
    "clickhouse",
    "analytics",
    "olap"
  ],
  "license": "MIT",
  "icon": "https://raw.githubusercontent.com/example/tabularis-clickhouse/main/assets/icon.svg",
  "homepage": "https://github.com/example/tabularis-clickhouse",
  "documentation_url": "https://github.com/example/tabularis-clickhouse#readme",
  "support": {
    "email": "maintainers@example.com",
    "issues_url": "https://github.com/example/tabularis-clickhouse/issues"
  },
  "screenshots": [
    {
      "url": "https://raw.githubusercontent.com/example/tabularis-clickhouse/main/assets/screen-connect.png",
      "caption": "Connection form with native ClickHouse fields",
      "alt": "Tabularis connection dialog showing host, port, user, and database fields"
    },
    {
      "url": "https://raw.githubusercontent.com/example/tabularis-clickhouse/main/assets/screen-query.png",
      "caption": "Running a SELECT against the ontime table",
      "alt": "Tabularis data grid showing ClickHouse query results"
    }
  ],
  "min_runtime_version": "0.9.13",
  "readme": "# ClickHouse driver for Tabularis\n\nAdds a native ClickHouse connection to Tabularis. Supports SELECT/INSERT/UPDATE/DELETE through execute_query, schema introspection for the explorer, DDL generation (CREATE TABLE, ALTER TABLE, DROP), and ER-diagram rendering via get_relationships.\n"
}

Themes (`theme`)

Declarative Tabularis theme packages. Registry schema preparation only; host release and package acceptance gates remain outstanding.

Extensions

Field	Type	Required	Description
`theme_schema_version`	`integer`	✅
`theme_variants`	`array<object>`	✅

Example (YAML)

id: example
name: example
version: example
description: example
category: example
kind: theme
tags:
  - example
license: example
icon: example
screenshots:
  - url: example
    caption: example
    alt: example
readme: example
readmes: {}
documentation_url: example
homepage: example
support:
  email: example
  issues_url: example
min_runtime_version: example
theme_schema_version: 1
theme_variants:
  - id: example
    name: example
    file: example

Example (JSON)

{
  "id": "example",
  "name": "example",
  "version": "example",
  "description": "example",
  "category": "example",
  "kind": "theme",
  "tags": [
    "example"
  ],
  "license": "example",
  "icon": "example",
  "screenshots": [
    {
      "url": "example",
      "caption": "example",
      "alt": "example"
    }
  ],
  "readme": "example",
  "readmes": {},
  "documentation_url": "example",
  "homepage": "example",
  "support": {
    "email": "example",
    "issues_url": "example"
  },
  "min_runtime_version": "example",
  "theme_schema_version": 1,
  "theme_variants": [
    {
      "id": "example",
      "name": "example",
      "file": "example"
    }
  ]
}

Generated by Tabularium for https://registry.tabularis.dev.

Plugin Kinds

Drivers (driver)

Extensions

Example (YAML)

Example (JSON)

Themes (theme)

Extensions

Example (YAML)

Example (JSON)

Drivers (`driver`)

Themes (`theme`)