Official
settings
Built-in settings UI (JavaScript UI plugin).
The app opens the listing; nothing installs until an agent in your Plugins workspace has read the files and you enable the plugin. In a terminal: dvg install divergence/settings@0.2.6
Permissions in 0.2.6
Files
views/workspaces.tsx2.3 KB
// The Workspaces section: each workspace folder, and the mark the app
// shows for it (its project icon, or a folder in one of the preset
// colours) wherever its chats are listed.
// HTM whitespace is significant; keep these templates out of Prettier's HTML formatter.
import type { EffectViewContext } from "divergence/effect";
import type { PresetColor, Workspace } from "divergence";
import type { SettingsPage } from "../controller.ts";
import { card, column, section, setting } from "./layout.tsx";
const title = (color: string) => color.charAt(0).toUpperCase() + color.slice(1);
/// The workspace's mark as it shows now, and the marks it can take.
function looks(w: Workspace, colors: readonly PresetColor[]) {
const own = w.icon ? { image: w.icon } : w.mark ? { icon: w.mark } : null;
const value = own && !w.useColor ? "icon" : (w.color ?? "");
return {
value,
options: [
...(own ? [{ value: "icon", label: w.icon ? "Project icon" : "App icon", ...own }] : []),
...colors.map((color) => ({ value: color, label: title(color), icon: "folder-solid", color })),
],
};
}
export function renderWorkspaces(ctx: EffectViewContext<object>, actions: SettingsPage["Service"]) {
const { workspaces, colors } = actions.state;
if (!workspaces.length) return <empty>No workspace folders yet. Add one from the sidebar.</empty>;
const rows = workspaces.map((w) => {
const { value, options } = looks(w, colors);
return setting({
title: w.name,
description: w.path,
control: colors.length
? (
<combobox id={`workspace-look-${w.id}`} value={value} width={220} options={options} onChange={(e: { value?: string }) => {
if (!e.value || e.value === value) return;
ctx.run(actions.setWorkspaceColor(w.id, e.value === "icon" ? null : (e.value as PresetColor)));
}} />
)
: null,
});
});
return (
<div {...column} gap="large" padding="small">
{section(
"Workspaces",
"The icon each workspace shows beside its chats: the project's own icon, or a folder in a colour. A folder without an icon gets a colour of its own. Right-click a workspace in the sidebar's list to change it there.",
card(rows),
)}
</div>
);
}Versions
| Version | Published | Plugin API | Size | Permissions | Status |
|---|---|---|---|---|---|
| 0.2.8latest | Nov 21, 2026 | >=5 <6 | 68.5 KB | 7 permissions | Listed |
| 0.2.7 | Nov 18, 2026 | >=5 <6 | 68 KB | 7 permissions | Listed |
| 0.2.6 | Nov 16, 2026 | >=5 <6 | 66.3 KB | 7 permissions | Listed |
| 0.2.5 | Nov 11, 2026 | >=5 <6 | 63.6 KB | 7 permissions | Listed |
| 0.2.4 | Nov 9, 2026 | >=5 <6 | 61.6 KB | 7 permissions | Listed |
| 0.2.3 | Oct 27, 2026 | >=2 <4 | 46.8 KB | 7 permissions | Listed |
No comments yet.