Scriptura Application Registry

This directory is the canonical registry of discoverable standalone applications for the Scriptura editor.

Applications are self-contained UI panels that appear in the application dock and provide specific functionality — Git integration, HTTP client, database viewer, terminal, debugger, and more.

How It Works

The registry.json file is a machine-readable database that Scriptura uses for:

• First-run installation prompt — new users are shown available apps to install
• In-editor downloads — future: one-click install from the application dock
• Prompted recommendations — future: suggested apps based on project type and context

Registry Format

{
  "$schema": "./registry-schema.json",
  "description": "...",
  "registryVersion": "1.0.0",
  "lastUpdated": "2026-07-29",
  "applications": [
    {
      "id": "com.scriptura.app.id",
      "name": "Display Name",
      "version": "1.0.0",
      "author": "Scriptura Team",
      "description": "Human-readable description of the application.",
      "downloadUrl": "https://github.com/org/repo",
      "homepage": "https://github.com/org/repo",
      "icon": "/icons/app.svg",
      "category": "development",
      "license": "MIT",
      "installed": false
    }
  ]
}

Fields

Field	Type	Description
id	string	Unique application identifier (reverse domain notation)
name	string	Human-readable display name (shown in dock)
version	string	Semantic version of the application
author	string	Application author or organization
description	string	One-paragraph summary of what the app does
downloadUrl	string	GitHub repository URL (or direct download URL)
homepage	string	Project homepage / documentation URL
icon	string	Path to icon resource (for dock display)
category	string	One of: development, source-control, editing
license	string	SPDX license identifier
installed	boolean	Whether the app is currently installed (false in registry)

Adding an Application

1. Add a new entry to applications[] in registry.json
2. Create the corresponding *-app/ directory with a CMakeLists.txt, plugin.json, and thin ScripturaApplication wrapper
3. Update "lastUpdated" to the current date
4. Submit a pull request

Note: All download URLs are currently placeholders. Replace them with actual GitHub repository URLs when the applications are published.