# Plugin reference template

This is a demonstration template, not a plugin to copy wholesale into
production. It intentionally declares every permission and supported
contribution group so the source and tests provide an example of every public
contract:

- game sources and browser capture;
- universal import/export;
- filters and data-only UI slots;
- custom game fields, tracking, and game actions;
- settings, storage migrations, and backup;
- jobs, diagnostics, managed cache, network, and the auth broker;
- lifecycle hooks and deterministic tests without Electron.

Copy `game-source-plugin` first for a normal provider. Use this template as a
reference when adding a specific capability: copy only the required manifest
section, minimum permission, and corresponding handler.

```sh
pnpm install
pnpm test
pnpm build
zip -r my-reference-plugin.xlplugin manifest.json runtime
```

The practical contract guide is in `../../docs/`.