Official Verstak plugins monorepo — files, notes, markdown-editor, preview, activity, journal, browser-inbox, search, secrets, templates + shared packages

Go to file

mirivlad 22c842d5e3 build: add Windows plugin packages		2026-07-13 21:46:40 +08:00
docs	docs: document todo plugin behavior	2026-07-10 21:08:50 +08:00
plugins	feat: stabilize activity sessions for journal review	2026-07-12 20:49:13 +08:00
scripts	build: add Windows plugin packages	2026-07-13 21:46:40 +08:00
.gitignore	build: add Windows plugin packages	2026-07-13 21:46:40 +08:00
AGENTS.md	Remove redundant Markdown preview provider	2026-06-27 23:58:30 +08:00
LICENSE	docs: prepare official plugins alpha release	2026-07-12 21:22:24 +08:00
README.md	build: add Windows plugin packages	2026-07-13 21:46:40 +08:00

README.md

Verstak Official Plugins

The first-party plugin set for Verstak Desktop: Files, Trash, Notes, editor and preview providers, Browser Inbox, Activity, Journal, Todo, Search, Secrets and Templates. Plugin bundles are built into independent directories that the desktop host loads from its plugins/ folder.

Alpha software. Build this repository together with compatible verstak-desktop and verstak-sdk checkouts.

Build

Requirements: Node.js with npm, Go and Python 3. Keep this repository next to verstak-sdk so manifest validation can use the SDK schema.

npm --version
go version
./scripts/check.sh
./scripts/build.sh

The build creates dist/<plugin-id>/ packages. To install them into a sibling desktop checkout:

cd ../verstak-desktop
./scripts/install-dev-plugins.sh

Windows test packages from Linux

Install a MinGW cross-compiler, then build a separate Windows amd64 package tree:

sudo apt install gcc-mingw-w64-x86-64
./scripts/build-windows.sh

The result is dist-windows/. Go sidecars, when a plugin has one, are emitted as backend/<plugin-id>.exe; frontends and manifests are the same packaged files used on Linux. This is a local test output and is not a GitHub Release.

Alpha behaviour

Browser Inbox archives processed captures and can restore them; permanent deletion is a separate action.
Saving a browser link creates a collision-safe .url file. Opening a link is handled by Verstak, so it does not depend on a Linux .url file association.
Activity sessions can be scoped to a durable workspace identity or to an explicit unassigned scope. Journal creation is always a user action.
Todo is optional: Overview uses it only when the Todo capability is present.

Release package

./scripts/release.sh v0.1.0-alpha.1

The command rebuilds all packages and writes release/verstak-official-plugins-<version>.tar.gz plus SHA256SUMS.

Publish a GitHub Release

./scripts/publish-github-release.sh v0.1.0-alpha.1

The publisher requires an authenticated gh CLI and a clean, up-to-date main. It runs the local release command, creates and pushes an annotated tag if necessary, then creates or updates the GitHub Release with the archive and SHA256SUMS. Re-running it for a tag that points at the current commit replaces the release assets.