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

2026-10-28 22:25:24 +00:00 · 2026-10-04 21:25:16 -05:00
1 parent a8f383d2b3
commit 29a946d02e
@@ -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]
+  }
+}
@@ -0,0 +1 @@
+custom: https://donate.termix.site/
@@ -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)
@@ -0,0 +1,9 @@
+node_modules
+dist
+coverage
+*.log
+.env
+*.tmxplug
+*.tmxplug.sig
+termix-plugin-signing.key
+.termix-tables-*
@@ -0,0 +1 @@
+npx --no -- commitlint --edit "$1"
@@ -0,0 +1 @@
+npx lint-staged
@@ -0,0 +1,4 @@
+dist
+coverage
+node_modules
+package-lock.json
@@ -0,0 +1,9 @@
+{
+  "semi": true,
+  "singleQuote": false,
+  "tabWidth": 2,
+  "trailingComma": "all",
+  "printWidth": 80,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}
@@ -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": "Share terminal, RDP, VNC and Telnet sessions"
+        },
+        {
+          "type": "added",
+          "text": "Share by link with anyone, or with a Termix user"
+        },
+        {
+          "type": "added",
+          "text": "Read-only or read and write"
+        },
+        {
+          "type": "added",
+          "text": "Links that expire or can be revoked"
+        },
+        {
+          "type": "added",
+          "text": "Meeting rooms where a presenter shows a session and can hand over control"
+        },
+        {
+          "type": "added",
+          "text": "Guest links for people without an account"
+        }
+      ]
+    }
+  ]
+}
@@ -1,7 +0,0 @@
-# Changelog
-
-## 1.0.0
-
-First release, bundled with Termix 2.9.0.
-
-Share a live terminal or remote desktop session by link or with another user, read-only or with input. Collaboration rooms let a presenter show sessions to a group.
@@ -0,0 +1,25 @@
+# Contributing to Session Sharing
+
+## 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
+```
+
+## Settings
+
+### Admin
+
+- **Allow Session Sharing:** turn sharing on or off for everyone. When off, it overrides every host setting
+
+### Host
+
+- **Allow Session Sharing:** allow sharing sessions on this host
+
+## Permissions
+
+- `session-sharing.use`: share sessions and create and join meeting rooms. Admins and users have it by default.
@@ -1,43 +1,52 @@
-# Session Sharing
+<div align="center">

-Share a live terminal or remote desktop session by link or with another user, and present sessions in collaboration rooms.
+<img src="https://raw.githubusercontent.com/Termix-SSH/Termix/main/public/icon.svg" width="120" height="120" alt="Termix Logo" />
+
+<h1>Session Sharing</h1>
+
+<p>Share live sessions and run meetings together</p>
+
+</div>
+
+<br />
+
+## Overview
+
+Session Sharing lets you share a live terminal or remote desktop session with someone else, and present sessions to a group in meeting rooms.
+
+<br />

 ## Features

- Share a live terminal or remote desktop session by link or with one user.
- Pick read-only or read and write, and set when the share expires.
- Collaboration rooms where a presenter shows a session to a group and can hand control to a member.
- Guest links for people without a Termix account.
- The share button is in the terminal and remote desktop toolbars.
+- Share terminal, RDP, VNC and Telnet sessions
+- Share by link with anyone, or with a Termix user
+- Read-only or read and write
+- Links that expire or can be revoked
+- Meeting rooms where a presenter shows a session and can hand over control
+- Guest links for people without an account

-## Settings
-
-### Admin
-
- Allow Session Sharing: turn sharing on or off for everyone.
-
-### Host
-
- Allow Session Sharing: allow sharing sessions on this host.
-
-## Permissions
-
- `session-sharing.use`: Share sessions and join rooms. Admins and users have it by default.
+<br />

 ## Services

 Provides to other plugins:

- `sessions.sharing`: join a shared session or room from the terminal.
+- `sessions.sharing`: join a shared session or room from the terminal

 Uses from other plugins:

- `sessions.live` to reach live SSH, RDP, VNC and Telnet sessions.
+- `sessions.live` to reach live SSH, RDP, VNC and Telnet sessions

-## 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,16 +2,16 @@
  "id": "session-sharing",
  "name": "Session Sharing",
  "version": "1.0.0",
-  "description": "Share a live terminal or remote desktop session by link or with another user, and present sessions in collaboration rooms.",
+  "description": "Share live sessions by link or with another user, and present sessions to a group in meeting rooms.",
  "author": {
    "name": "Termix"
  },
-  "license": "MIT",
+  "license": "Apache-2.0",
  "repository": "https://github.com/Termix-SSH/Termix",
  "category": "Productivity",
  "icon": "Presentation",
  "engine": {
-    "termix": ">=2.9.0",
+    "termix": ">=26.10.0",
    "api": "1"
  },
  "capabilities": [
@@ -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": {
    "@xterm/addon-fit": "^0.11.0",
@@ -17,6 +20,8 @@
    "redis": "^6.2.1"
  },
  "devDependencies": {
+    "@commitlint/cli": "^21.2.2",
+    "@commitlint/config-conventional": "^21.2.0",
    "@termix/plugin-sdk": "^1.0.0",
    "@testing-library/dom": "^10.4.2",
    "@testing-library/react": "^16.3.3",
@@ -24,7 +29,10 @@
    "@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": {
@@ -44,5 +52,10 @@
    "react-xtermjs": {
      "@xterm/xterm": "$@xterm/xterm"
    }
+  },
+  "lint-staged": {
+    "*.{ts,tsx,js,jsx,mjs,cjs,json,css,md}": [
+      "prettier --write"
+    ]
  }
 }