Configure the plugin manifest
Every plugin release includes manifest.json. Phials reads it before importing plugin JavaScript, so the manifest must describe the release accurately without running any plugin code.
The manifest owns:
- permanent plugin identity
- user-facing name, author, and description
- release version
- minimum Phials version
- targeted Plugin API version
- requested plugin permissions
- public links and preload icons
It does not register capabilities or contain plugin settings. Those belong to the default PhialsPlugin export.
Start from the plugin starter
Author src/plugin.manifest.ts with helpers from
@phoundry/phials-plugin-sdk/manifest. It imports version from
../package.json, the sole release-version source. The current starter pins
@phoundry/phials-plugin-sdk to 3.1.0.
src/main.ts exports the source manifest as manifest, exports Svelte
mount and unmount, and uses definePlugin(pluginManifest, …) for its
default export. The build derives dist/manifest.json and
release/release-inventory.json from that same bundle. Never patch these
outputs by hand; there is no separate authored JSON manifest or sync step.
Configure it in order
- Create and synchronize a plugin manifest
- Choose a stable plugin ID and public metadata
- Declare Phials and Plugin API compatibility
- Request the least plugin permissions
- Validate a plugin manifest
A complete small manifest
{ "id": "acme.review-tools", "name": "Review Tools", "version": "1.2.0", "minAppVersion": "1.4.0", "pluginApiVersion": "3.0.0", "author": "Acme", "description": "Adds review commands and file annotations.", "authorUrl": "https://acme.example", "repository": "https://github.com/acme/review-tools", "icons": ["phoundry-mono:check", "phoundry-mono:circle-info"], "permissions": []}This is an example of the emitted JSON, not a second file to author. Every field has one job. Do not add provider declarations, arbitrary configuration, release notes, or undocumented metadata.
Keep the release identities aligned
One release has one identity and version across:
package.json.version → src/plugin.manifest.ts → bundled manifest export → default PhialsPlugin export → dist/manifest.json → release inventory and tagplugin ID → installed directory nameThe plugin ID is permanent. The version changes for releases. A mismatch is a validation or load failure, not a migration mechanism.
Use the reference for exact lookup
These task articles explain how to make decisions. Use Plugin manifest field reference for the exhaustive field schema and Plugin permission reference for exact permission names.
For the broader runtime boundary, see Version and compatibility reference and Community plugin trust model.