mirror of
https://github.com/storytold/effectcraft.git
synced 2026-11-16 15:22:43 +00:00
When a package names a `repo` that isn't a GitHub repository URL (`https://github.com/<owner>/<repo>`, a trailing `/` or `.git` allowed, or a folder in one, `.../tree/<ref>/<path>`), Install, Update and Preview now refuse its release URLs with an error naming the package. Before, such a `repo` skipped the repository check and any GitHub release asset was downloaded. A package without a `repo` keeps any repository's release asset. The example catalog's schema now holds `repo` and release `url` to the same forms, and `scripts/validate.sh` checks that every release is an asset of the package's `repo` before it downloads anything.
EffectCraft plug-ins
The community catalog of WebAssembly effect plug-ins for
EffectCraft. The app's Plug-in Library
(Settings ▸ Plug-in Library) reads index.json from this repository, then
downloads, checks and installs the packages people pick. Plug-ins run in EffectCraft's sandbox:
they can't read files, open the network or crash the app.
This repository holds only the catalog. Each plug-in's code and .wasm live in its author's
repository, attached to a GitHub release.
Submit a plug-in
- Build your plug-in and attach the
.wasmto a GitHub release. The full guide is Publishing plug-ins. - Add one entry to the
packagesarray ofindex.json.example-entry.jsonshows every field;schema.jsonis the exact format. To publish a new version, add a release to your package'sversionsrather than editing an old one. - Check it locally:
scripts/validate.sh(needs bash, jq, curl, sha256sum and Node; setEFFECTCRAFT_CLIto aneffectcraft-clibuild to also install it with the real loader). - Open a pull request. CI runs the same script; a maintainer reviews the rest.
Review checklist (maintainers)
CI checks the format, unique ids, each download's size and SHA-256, and that EffectCraft installs and loads the package. Before merging, also check:
- The id is new, stable and names the author (reverse domain style:
io.github.user.name). Ids never change and are never reused. repois a public repository with the plug-in's source, and its licence is open (thelicensefield matches it).- Every
urlis a release asset of that repository (not a branch file, which can change). - The release builds from the tagged source; spot-check large or obfuscated modules.
effectslists the effect ids the module registers, and they don't clash with another package's.name,descriptionandtagsare accurate; no Adobe names, logos or assets.preview.video, if given, is a short demo of the effect hosted on GitHub or a well-known video site.- A change to an existing package comes from its author (or with their agreement), and old releases keep their url and SHA-256.
Create this repository from the template
The template lives in EffectCraft at examples/plugin-catalog/.
- Create the empty public repository
storytold/effectcraft-plugins(branchmain, so the app's catalog URLhttps://raw.githubusercontent.com/storytold/effectcraft-plugins/main/index.jsonresolves). - Copy
README.md,index.json,example-entry.json,schema.jsonandscripts/to its root, andvalidate.ymlto.github/workflows/validate.yml. - Keep
scripts/validate.shexecutable (git update-index --chmod=+x scripts/validate.sh). - Protect
main: require pull requests and theValidatecheck.