Publishing Plugins

Publishing Plugins

Full guide at: docs/plugins/publishing.md

Account Setup

1. Register at cortexprism.io/register
2. Verify your email
3. Create API token for automated publishing

Publish via Web UI

1. Go to Publish Plugin
2. Fill in: name, version, description, kind, entry point, capabilities
3. Add author, links, icon, screenshots, tags
4. Submit for review

Publish via API (CI/CD)

TOKEN=$(curl -s -X POST https://cortexprism.io/api/auth/login \
  -H 'Content-Type: application/json' \
  -d '{"email":"user@example.com","password":"your-password"}' \
  | jq -r '.token')

curl -X POST https://cortexprism.io/api/marketplace/plugins \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "name": "my-plugin", "version": "1.0.0", ... }'

Review Process

1. Status: pending → admin review (within 48 hours)
2. Approved → live on marketplace
3. Rejected → fix issues, increment version, resubmit

Version Management

• Follow SemVer
• Tag releases with v{version} (e.g. v1.0.0)
• Once published, a version is immutable — publish new PATCH versions for fixes

Requirements

Requirement	Details
Naming	kebab-case, unique across marketplace
Version	Valid semver
Entry point	Must be accessible
License	SPDX identifier required
README	Strongly recommended
Icon	Recommended: 256x256 PNG/SVG

Full Documentation

See Submission Standards for:

• Repository structure requirements
• CHANGELOG and README templates
• AI disclosure requirements
• Pre-submission checklist
• GitHub Actions CI/CD for automated publishing

See Also

• Plugin System — System overview
• Developing Plugins — Development guide