chore: simplify plugin readmes, changelogs and manifest descriptions

This commit is contained in:
LukeGus committed 2026-09-27 00:24:48 -05:00
1 parent 7423e33184
commit 8043d6dbdd
96 files changed
+1147 -722

No files matched your search

+2 -17
View File
@@ -2,21 +2,6 @@
## 1.0.0
Bundled with Termix 2.9.0.
First release, bundled with Termix 2.9.0.
- Homepage and the dashboard's service links moved out of core's own
servers on ports 30006 (dashboard) and 30012 (homepage), and now serve
under `/plugin-api/homepage`.
- Owns its data: core's `homepage_items`, `homepage_layouts` and
`dashboard_service_links` tables are renamed to `p_homepage_*` on first
activation.
- The favicon, RSS, ping and custom-API outbound requests now go through
`ctx.fetch` instead of a raw fetch, keeping the same SSRF guard.
- New `homepage.use` permission, given to the admin and user roles.
- Offers `homepage.items` v1 to other plugins; the AI assistant reads it
optionally.
- The dashboard's "Dashboard / Homepage" toggle is now a contribution to
core's generic `dashboard.secondaryView` slot rather than a hardcoded
homepage case.
- Core's uptime, recent-activity and database-health routes stayed on the
main server, now under `/dashboard` rather than a dedicated port.
Adds a custom page of widgets, like clocks, notes, host status, RSS feeds and an embedded terminal. Also adds service link buttons to the dashboard.
+20 -46
View File
@@ -1,57 +1,31 @@
# Homepage
A customizable widget canvas (clock, notes, host status, RSS feeds, an
embedded terminal, and more) plus the dashboard's service link buttons.
A custom widget page and service links for your servers and services.
Bundled with Termix and enabled by default. It imports only
`@termix/plugin-sdk`.
## Features
## What it does
- A page of widgets you can move, resize, pan and zoom. Open it from the command palette.
- Widgets for clocks, notes, folders, host status, bookmarks, weather, RSS feeds, ping checks, calendars, countdowns, search, images, custom APIs, an embedded terminal and more.
- Other features can add their own widgets, like Docker, Tunnels, File Manager and Host Metrics.
- Service link buttons and a homepage preview for the dashboard.
- Widgets and service links sync between the desktop app and a server.
- **The canvas**: a pannable, zoomable grid of widgets, opened as its own
tab (singleton, `?view=homepage`) or from the command palette. Widgets
save their own layout and config.
- **Widget types**: clock, notes, markdown notes, folders, host status,
host grid, bookmarks, weather, iframe embed, RSS feed, ping status,
recent activity, Termix uptime, system overview, an embedded SSH terminal,
quick connect, calendar, countdown, search bar, text banner, image,
custom API, service grid, dashboard links, search shortcuts and link
trees. Other plugins (docker, tunnels, file-manager, host-metrics) add
their own widget types through `app.registerHomepageWidget`; the widget
type registry itself lives in core
(`src/ui/plugin-host/homepage-widget-registry.ts`) so those widgets keep
working with this plugin disabled.
- **Dashboard cards**: `service_links` (clickable service URL buttons) and
`homepage_preview` (a read-only scaled preview of the canvas), both
offered in the dashboard's card tray. The dashboard's "Dashboard /
Homepage" toggle is a contribution to core's generic
`dashboard.secondaryView` slot.
- **Outbound requests**: the favicon, RSS, ping and custom-API widgets fetch
through `ctx.fetch`, which keeps the SSRF guard (private and loopback
addresses refused, no redirects, DNS pinned) every other plugin's outbound
call gets.
- **`homepage.items`**: a service the AI assistant reads optionally, to list
a user's homepage tiles.
## Permissions
## Layout
- `homepage.use`: Use the homepage. Admins and users have it by default.
manifest.json id, capabilities and what this plugin contributes
src/backend/ activate(ctx), routes, the outbound proxy routes
src/frontend/ the canvas, widgets, dialogs and dashboard cards
migrations/ one .sql per dialect, generated from src/backend/tables.ts
locales/en.json its strings (English only; the rest are translated)
tests/backend/ vitest, node
tests/frontend/ vitest, jsdom
## Services
## Data
Provides to other plugins:
- `p_homepage_homepage_items`, `p_homepage_homepage_layouts` and
`p_homepage_dashboard_service_links`, adopted from core's `homepage_items`,
`homepage_layouts` and `dashboard_service_links`.
- `homepage.items`: list a user's homepage widgets.
Core's own uptime, recent-activity and database-health routes are unrelated
to the canvas and stay on the main server
(`src/backend/database/routes/dashboard-routes.ts`, mounted at
`/dashboard`).
## Development
See packages/plugin-sdk/ARCHITECTURE.md for the contract this follows.
```bash
npm run build # build into dist/
npm run test # run this plugin's tests
npm run typecheck # type-check this plugin
```
See `packages/plugin-sdk/ARCHITECTURE.md` for the plugin contract.
+1 -1
View File
@@ -2,7 +2,7 @@
"id": "homepage",
"name": "Homepage",
"version": "1.0.0",
"description": "A customizable widget canvas and dashboard service links for your servers and services.",
"description": "A custom widget page and service links for your servers and services.",
"author": {
"name": "Termix"
},