chore: rework plugin readmes, json changelogs and standalone repo setup

packages/plugin-sdk/README.md

@@ -1,18 +1,62 @@
-# @termix/plugin-sdk
+<div align="center">
 
-Everything a [Termix](https://github.com/Termix-SSH/Termix) plugin builds
-against: the types for `activate(ctx)` and `activate(app)`, table
-definitions, the manifest schema, test helpers, a vitest preset and the
-`termix-plugin` CLI.
+<img src="https://raw.githubusercontent.com/Termix-SSH/Termix/main/public/icon.svg" width="120" height="120" alt="Termix Logo" />
+
+<h1>Termix Plugin SDK</h1>
+
+<p>Everything you need to build a Termix plugin</p>
+
+</div>
+
+<br />
+
+## Overview
+
+`@termix/plugin-sdk` is what every [Termix](https://github.com/Termix-SSH/Termix) plugin builds against, including the ones that ship with Termix. It has the types for a plugin's backend and frontend, table definitions, the manifest schema, test helpers, and the `termix-plugin` CLI. The easiest way to start is the [Termix Plugin Template](https://github.com/Termix-SSH/Termix-Plugin-Template).
+
+<br />
+
+## What's Inside
+
+- **Backend:** the types for `activate(ctx)`, database and table helpers, host commands and SSH certificates
+- **Frontend:** the types for `activate(app)`, plus `@termix/plugin-sdk/ui`, the components and theme Termix serves to plugins
+- **Manifest:** the manifest schema, the capability catalog and settings types
+- **Testing:** `createMockCtx()`, `createTestDb()`, `renderWithApp()` and a Vitest preset
+- **CLI:** `termix-plugin`, which builds, tests, validates, packs and signs a plugin and writes its migrations
+
+<br />
+
+## Installation
 
 ```bash
 npm install --save-dev @termix/plugin-sdk
-npx termix-plugin build      # bundle dist/backend.js and dist/frontend.js
-npx termix-plugin test       # run the plugin's vitest suite
-npx termix-plugin validate   # check manifest.json and the files it names
-npx termix-plugin pack       # write <id>-<version>.tmxplug
-npx termix-plugin sign <file.tmxplug>   # needs TERMIX_PLUGIN_SIGNING_KEY
 ```
 
-Start from
-[Termix-Plugin-Template](https://github.com/Termix-SSH/Termix-Plugin-Template).
+<br />
+
+## CLI
+
+```bash
+npx termix-plugin build                  # bundle dist/backend.js and dist/frontend.js
+npx termix-plugin test                   # run the plugin's Vitest suite
+npx termix-plugin validate               # check manifest.json and the files it names
+npx termix-plugin migrations             # write migrations from the table definitions
+npx termix-plugin pack                   # write <id>-<version>.tmxplug
+npx termix-plugin sign <file.tmxplug>    # sign it, needs TERMIX_PLUGIN_SIGNING_KEY
+npx termix-plugin verify <file.tmxplug> --key <base64>   # check a signature
+npx termix-plugin keygen --out <dir>     # make a new signing key pair
+```
+
+<br />
+
+## Support
+
+To report a bug or request a feature, open a [support ticket](https://github.com/Termix-SSH/Support/issues/new/choose). You need to be logged in to GitHub. Please be as detailed as possible, preferably in English.
+
+For discussions and questions, join the [Discord](https://discord.gg/jVQGdvHDrf) server.
+
+<br />
+
+## License
+
+Distributed under the Apache License Version 2.0. See [LICENSE](https://github.com/Termix-SSH/Termix/blob/main/LICENSE) for more information.