Skip to content
SceneCMS

Marketplace

Installing modules and themes, and how signed packages are verified.

What the marketplace is

A catalogue of modules and themes for SceneCMS, opened from Admin → Marketplace. Each product has a version, a compatibility range and a signed package behind it.

Only the vendor's own products are published today. The schema already supports third-party authors, so the catalogue can grow without a migration.

Installing

  1. Open Admin → Marketplace. The catalogue is fetched with your license key and domain, so it knows what you own.
  2. Press Install on a free product, or Update when a newer version is offered.
  3. The package is downloaded, its signature and per-file checksums are verified, and the files are placed in the right directory.

Nothing is activated behind your back: after installation a module is disabled and a theme is inactive until you press Enable or Activate.

What is verified

A marketplace package is a zip with:

marketplace-manifest.json      slug, version, files with SHA-256
marketplace-manifest.sig       detached Ed25519 signature
files/<path>                   the payload

Before a single file is written, the installer checks the signature against the public key shipped in the product, then every file's checksum, then that the manifest's slug and version match the module.json or theme.json inside. A package with one modified byte is rejected.

Path traversal is refused as well, so a crafted zip cannot write outside the target directory.

Rollback

The previous build of a module or theme is moved to storage/app/marketplace/rollback before the new one is put in place. If the copy fails, the old build is restored.

Licensing rules

  • Free products: any installation with an active license.
  • Paid products: an order issued in the client area.
  • Installing new products requires a valid license. What is already installed keeps working forever, including after the support year ends.
  • Updates to installed products follow the same rule as new installs.

That is deliberate: a lapsed license must never break a running site, only pause the shop.

Writing your own

A module is a directory with module.json, a service provider and optional routes, views and migrations. A theme is a directory with theme.json and Blade overrides. Both are covered in the product documentation shipped with the archive.

If you want to publish on the marketplace later, the vendor schema and the review queue are already in the client area — write to us and we will open the account.

Not covered here?

Write to sales@scenecms.com — we answer within one business day.

Contact