Publishing — Potion docs
Potion

Publishing

Publishing

Prepare potion.json, validate an archive, submit review, and publish an immutable semantic release.

Publishers create a draft, select a type-specific contract, upload a ZIP or TAR.GZ archive, and submit it for review. Potion treats every archive as untrusted data and never executes its contents.

Release checklist

  1. Add a valid potion.json at the archive root.
  2. Declare compatibility, permissions, files, and dependencies.
  3. Upload and resolve every validation issue.
  4. Submit editorial review and address a requested change.
  5. Publish a new semantic version and verify its checksum.

Published archives and premium object prefixes are immutable. Use deprecation or yanking for lifecycle changes.