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

Go to file

mirivlad 03f5299209 Плагин verstak.workspace-folders: иконки, цвета, drag-and-drop - Заменяет дерево Дел через workspaceTree contribution - IconPicker: 1703 иконки Lucide с typeahead-поиском - ColorPicker: 12 предустановленных цветов - Drag-and-drop перемещение Дел между папками - Создание и редактирование папок с иконкой/цветом - Создание Дела с выбором родительской папки - Локализация: EN + RU, release notes v0.1.0-alpha.5		2026-07-18 18:54:42 +08:00
docs	docs: use Deal terminology in official plugins	2026-07-14 23:50:59 +08:00
plugins	Плагин verstak.workspace-folders: иконки, цвета, drag-and-drop	2026-07-18 18:54:42 +08:00
release-notes	Плагин verstak.workspace-folders: иконки, цвета, drag-and-drop	2026-07-18 18:54:42 +08:00
scripts	Expose remote vault pairing in sync plugin	2026-07-17 04:11:12 +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	Документация: удалён черновик PLAN_FILES_IMPROVEMENTS, добавлен README.ru.md с шапкой	2026-07-18 18:06:44 +08:00
README.ru.md	Документация: удалён черновик PLAN_FILES_IMPROVEMENTS, добавлен README.ru.md с шапкой	2026-07-18 18:06:44 +08:00

README.md

Verstak Official Plugins

The first-party plugin set — Files, Notes, Editor, Activity, Journal and more.

English · Русский

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

Verstak Official Plugins is the first-party plugin set for Verstak Desktop: Files, Trash, Notes, Default Editor, File Preview, Browser Inbox, Activity, Journal, Todo, Search, Secrets, Sync, and Templates. Plugin bundles are built into independent directories that the desktop host loads from its plugins/ folder.

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

Portable plugin archives

Build target-specific archives on Linux:

sudo apt install gcc-mingw-w64-x86-64
./scripts/package-portable.sh v0.1.0-alpha.1

The command creates release/verstak-official-plugins-linux-amd64-<version>.tar.gz and release/verstak-official-plugins-windows-amd64-<version>.zip, plus SHA256SUMS. Each archive expands directly into the desktop application's plugins/ directory. Frontends and manifests are shared; native Go sidecars are built for the target OS. This is a local package operation and does not create 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 Deal 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.

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 Linux archive, Windows archive and SHA256SUMS. Alpha, beta and release-candidate tags are published as prereleases; stable tags are marked latest. Re-running it for a tag that points at the current commit replaces the release assets.