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

This commit is contained in:
LukeGus committed 2026-10-04 21:25:16 -05:00
1 parent a8f383d2b3
commit 29a946d02e
500 files changed
+6729 -1250

No files matched your search

+21
View File
@@ -0,0 +1,21 @@
{
"extends": ["@commitlint/config-conventional"],
"rules": {
"type-enum": [
2,
"always",
[
"feat",
"fix",
"docs",
"style",
"refactor",
"perf",
"test",
"chore",
"revert"
]
],
"subject-case": [0]
}
}
+1
View File
@@ -0,0 +1 @@
custom: https://donate.termix.site/
+34
View File
@@ -0,0 +1,34 @@
# Overview
_Short summary of what this PR does_
- [ ] Added: ...
- [ ] Updated: ...
- [ ] Removed: ...
- [ ] Fixed: ...
# Changes Made
_Detailed explanation of changes (if needed)_
- ...
# Related Issues
_Link any issues this PR addresses_
- Closes #ISSUE_NUMBER
- Related to #ISSUE_NUMBER
# Screenshots / Demos
_(Optional: add before/after screenshots, GIFs, or console output)_
# Checklist
- [ ] Code follows project style guidelines
- [ ] Supports mobile and desktop UI/app (if applicable)
- [ ] Added the change to `CHANGELOG.json`
- [ ] `npm run test`, `npm run typecheck` and `npm run validate` pass
- [ ] I have read `CONTRIBUTING.md`
- [ ] This is not a translation request. See [docs](https://docs.termix.site/translations)
+9
View File
@@ -0,0 +1,9 @@
node_modules
dist
coverage
*.log
.env
*.tmxplug
*.tmxplug.sig
termix-plugin-signing.key
.termix-tables-*
+1
View File
@@ -0,0 +1 @@
npx --no -- commitlint --edit "$1"
+1
View File
@@ -0,0 +1 @@
npx lint-staged
+4
View File
@@ -0,0 +1,4 @@
dist
coverage
node_modules
package-lock.json
+9
View File
@@ -0,0 +1,9 @@
{
"semi": true,
"singleQuote": false,
"tabWidth": 2,
"trailingComma": "all",
"printWidth": 80,
"arrowParens": "always",
"endOfLine": "lf"
}
+34
View File
@@ -0,0 +1,34 @@
{
"$schema": "https://raw.githubusercontent.com/Termix-SSH/Termix/main/packages/plugin-sdk/schema/changelog.schema.json",
"releases": [
{
"version": "1.0.0",
"changes": [
{
"type": "added",
"text": "Group hosts by hand or with tag rules, so new hosts join on their own"
},
{
"type": "added",
"text": "Run one command on every host and see each result"
},
{
"type": "added",
"text": "Install, remove or upgrade packages across the fleet"
},
{
"type": "added",
"text": "Push and pull files on every host"
},
{
"type": "added",
"text": "Collect an inventory of OS, kernel, architecture and uptime"
},
{
"type": "added",
"text": "Share a fleet with users or roles"
}
]
}
]
}
-7
View File
@@ -1,7 +0,0 @@
# Changelog
## 1.0.0
First release, bundled with Termix 2.9.0.
Groups hosts into fleets, either by hand or by tag. Run commands, package actions and file transfers on every host in a fleet at once, and see an inventory of its hosts.
+17
View File
@@ -0,0 +1,17 @@
# Contributing to Fleets
## Development
```bash
npm run build # build into dist/
npm run test # run this plugin's tests
npm run typecheck # type-check this plugin
npm run validate # check manifest.json
npm run format # format the code with Prettier
```
## Permissions
- `fleets.view`: see fleets, their hosts and their inventory. Admins and users have it by default.
- `fleets.manage`: create, edit, delete and share fleets. Admins and users have it by default.
- `fleets.execute`: run commands, package actions and file transfers on a fleet. Admins and users have it by default.
+36 -20
View File
@@ -1,32 +1,48 @@
# Fleets
<div align="center">
Group hosts into fleets and run commands, package actions and file transfers on all of them at once.
<img src="https://raw.githubusercontent.com/Termix-SSH/Termix/main/public/icon.svg" width="120" height="120" alt="Termix Logo" />
<h1>Fleets</h1>
<p>Run commands and actions across many hosts at once</p>
</div>
<br />
## Overview
Fleets groups your hosts so you can act on all of them together.
<br />
## Features
- Group hosts into fleets by hand or by tag. Hosts with a matching tag join on their own.
- Run a command on every host in a fleet at once and see each result.
- Run package actions, like updates, across a fleet.
- Transfer files to and from every host in a fleet.
- See an inventory of the hosts in a fleet.
- Share fleets with other users or roles.
- Group hosts by hand or with tag rules, so new hosts join on their own
- Run one command on every host and see each result
- Install, remove or upgrade packages across the fleet
- Push and pull files on every host
- Collect an inventory of OS, kernel, architecture and uptime
- Share a fleet with users or roles
## Permissions
- `fleets.view`: See fleets, their hosts and inventory. Admins and users have it by default.
- `fleets.manage`: Create, edit, delete and share fleets. Admins and users have it by default.
- `fleets.execute`: Run commands, package actions and file transfers on a fleet. Admins and users have it by default.
<br />
## Services
Provides to other plugins:
- `fleets.access`: list fleets and run actions on them.
- `fleets.access`: list fleets and run actions on them
## Development
<br />
```bash
npm run build # build into dist/
npm run test # run this plugin's tests
npm run typecheck # type-check this plugin
```
## 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.
+2 -2
View File
@@ -6,12 +6,12 @@
"author": {
"name": "Termix"
},
"license": "MIT",
"license": "Apache-2.0",
"repository": "https://github.com/Termix-SSH/Termix",
"category": "Infrastructure",
"icon": "Boxes",
"engine": {
"termix": ">=2.9.0",
"termix": ">=26.10.0",
"api": "1"
},
"capabilities": [
+14 -1
View File
@@ -7,7 +7,10 @@
"build": "termix-plugin build",
"test": "termix-plugin test",
"typecheck": "tsc -p .",
"validate": "termix-plugin validate"
"validate": "termix-plugin validate",
"format": "prettier --write .",
"format:check": "prettier --check .",
"prepare": "husky || true"
},
"dependencies": {
"clsx": "^2.1.1",
@@ -16,12 +19,17 @@
"tailwind-merge": "^3.5.0"
},
"devDependencies": {
"@commitlint/cli": "^21.2.2",
"@commitlint/config-conventional": "^21.2.0",
"@termix/plugin-sdk": "^1.0.0",
"@types/node": "^26.2.0",
"@types/react": "^19.2.18",
"@types/react-dom": "^19.2.4",
"better-sqlite3": "^13.0.3",
"husky": "^9.1.7",
"jsdom": "^30.0.1",
"lint-staged": "^17.2.0",
"prettier": "3.9.9",
"vitest": "^4.1.11"
},
"peerDependencies": {
@@ -32,5 +40,10 @@
"react": "^19.2.8",
"sonner": "^2.0.8",
"ssh2": "^1.17.0"
},
"lint-staged": {
"*.{ts,tsx,js,jsx,mjs,cjs,json,css,md}": [
"prettier --write"
]
}
}