Skip to content

README.md

Latest commit

 

History

History
115 lines (90 loc) · 2.57 KB

README.md

File metadata and controls

115 lines (90 loc) · 2.57 KB
Raw

Repository Extension Catalog

This directory is the public download source for MacPad Pro extensions.

MacPad Pro reads:

https://raw.githubusercontent.com/anvilfilbert/MacPadPro/main/RepositoryExtensions/catalog.json

Each extension has one directory:

RepositoryExtensions/<extension-id>/<extension-id>.macpadproext

Extensions can include extra package-owned files in the same directory. Script text-command extensions use:

RepositoryExtensions/<extension-id>/transform.js

The manifest must include scriptCommand.sourceURL and scriptCommand.sourceSHA256 so Extension Manager can download and verify the script before saving it locally.

Data-driven extensions can declare verified resource files:

{
  "resources": [
    {
      "file": "themes.json",
      "sourceURL": "https://raw.githubusercontent.com/anvilfilbert/MacPadPro/main/RepositoryExtensions/pro-themes/themes.json",
      "sourceSHA256": "..."
    }
  ]
}

Theme packages also declare the resource that contains color definitions:

{
  "themeResource": {
    "file": "themes.json"
  }
}

The .macpadproext manifest must match the catalog entry exactly:

  • id
  • title
  • description
  • version
  • kind

Manifests can also include compatibility metadata:

  • packageFormatVersion
  • minimumMacPadProVersion

If any value differs, Extension Manager rejects the package.

Extension Manager also displays optional trust metadata:

  • author
  • permissions

Installed packages show Update Available when this catalog publishes a newer semantic version than the local package.

Current Keywords

Use these terms in extension descriptions when relevant so users can find packages through Extension Manager search:

  • markdown
  • preview
  • export
  • pdf
  • html
  • rtf
  • statistics
  • diff
  • backup
  • versions
  • clipboard
  • snippets
  • outline
  • navigation
  • csv
  • tsv
  • table
  • encoding
  • line endings
  • focus mode
  • themes
  • formatter
  • php
  • c++
  • json
  • ai agent
  • ollama
  • openrouter
  • javascript
  • script command
  • title case

Publishing Checklist

  • Add source under Sources/NotepadMacCore/Extensions/<extension-id>/.
  • Add package under RepositoryExtensions/<extension-id>/.
  • Add catalog entry in RepositoryExtensions/catalog.json and update the pinned catalog SHA-256 before release.
  • Add package entry to ExtensionCatalog.default.
  • Add SHA-256 checksums for every package-owned resource file.
  • Update README.md and docs when the extension adds a new user-facing capability.
  • Run ./scripts/verify-public-repo.sh and ./scripts/verify-release.sh before publishing.