@dxos/plugin-board 0.8.4-main.fcfe5033a5 → 0.8.4-staging.60fe92afc8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-board",
-  "version": "0.8.4-main.fcfe5033a5",
+  "version": "0.8.4-staging.60fe92afc8",
   "description": "Surface plugin for card baords",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -8,94 +8,115 @@
     "type": "git",
     "url": "https://github.com/dxos/dxos"
   },
-  "license": "MIT",
+  "license": "FSL-1.1-Apache-2.0",
   "author": "DXOS.org",
   "sideEffects": true,
   "type": "module",
   "imports": {
-    "#capabilities": "./src/capabilities/index.ts",
-    "#components": "./src/components/index.ts",
-    "#containers": "./src/containers/index.ts",
-    "#meta": "./src/meta.ts",
-    "#types": "./src/types/index.ts"
+    "#capabilities": {
+      "source": "./src/capabilities/index.ts",
+      "types": "./dist/types/src/capabilities/index.d.ts",
+      "default": "./dist/lib/neutral/capabilities/index.mjs"
+    },
+    "#components": {
+      "source": "./src/components/index.ts",
+      "types": "./dist/types/src/components/index.d.ts",
+      "default": "./dist/lib/neutral/components/index.mjs"
+    },
+    "#containers": {
+      "source": "./src/containers/index.ts",
+      "types": "./dist/types/src/containers/index.d.ts",
+      "default": "./dist/lib/neutral/containers/index.mjs"
+    },
+    "#meta": {
+      "source": "./src/meta.ts",
+      "types": "./dist/types/src/meta.d.ts",
+      "default": "./dist/lib/neutral/meta.mjs"
+    },
+    "#plugin": {
+      "source": "./src/BoardPlugin.tsx",
+      "types": "./dist/types/src/BoardPlugin.d.ts",
+      "default": "./dist/lib/neutral/BoardPlugin.mjs"
+    },
+    "#translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "default": "./dist/lib/neutral/translations.mjs"
+    },
+    "#types": {
+      "source": "./src/types/index.ts",
+      "types": "./dist/types/src/types/index.d.ts",
+      "default": "./dist/lib/neutral/types/index.mjs"
+    }
   },
   "exports": {
     ".": {
       "source": "./src/index.ts",
-      "browser": "./dist/lib/browser/index.mjs",
-      "node": "./dist/lib/node-esm/index.mjs",
-      "types": "./dist/types/src/index.d.ts"
+      "types": "./dist/types/src/index.d.ts",
+      "default": "./dist/lib/neutral/index.mjs"
     },
-    "./types": {
-      "source": "./src/types/index.ts",
-      "browser": "./dist/lib/browser/types/index.mjs",
-      "node": "./dist/lib/node-esm/types/index.mjs",
-      "types": "./dist/types/src/types/index.d.ts"
+    "./assets/PLUGIN.mdl": "./PLUGIN.mdl",
+    "./plugin": {
+      "source": "./src/plugin.ts",
+      "types": "./dist/types/src/plugin.d.ts",
+      "default": "./dist/lib/neutral/plugin.mjs"
+    },
+    "./translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "default": "./dist/lib/neutral/translations.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "types": [
-        "dist/types/src/types/index.d.ts"
-      ]
-    }
-  },
   "files": [
     "dist",
-    "src"
+    "src",
+    "PLUGIN.mdl"
   ],
   "dependencies": {
-    "effect": "3.20.0",
-    "@dxos/app-toolkit": "0.8.4-main.fcfe5033a5",
-    "@dxos/ai": "0.8.4-main.fcfe5033a5",
-    "@dxos/assistant": "0.8.4-main.fcfe5033a5",
-    "@dxos/async": "0.8.4-main.fcfe5033a5",
-    "@dxos/blueprints": "0.8.4-main.fcfe5033a5",
-    "@dxos/app-framework": "0.8.4-main.fcfe5033a5",
-    "@dxos/client": "0.8.4-main.fcfe5033a5",
-    "@dxos/echo": "0.8.4-main.fcfe5033a5",
-    "@dxos/effect": "0.8.4-main.fcfe5033a5",
-    "@dxos/invariant": "0.8.4-main.fcfe5033a5",
-    "@dxos/log": "0.8.4-main.fcfe5033a5",
-    "@dxos/plugin-client": "0.8.4-main.fcfe5033a5",
-    "@dxos/operation": "0.8.4-main.fcfe5033a5",
-    "@dxos/plugin-search": "0.8.4-main.fcfe5033a5",
-    "@dxos/plugin-space": "0.8.4-main.fcfe5033a5",
-    "@dxos/plugin-graph": "0.8.4-main.fcfe5033a5",
-    "@dxos/random": "0.8.4-main.fcfe5033a5",
-    "@dxos/echo-react": "0.8.4-main.fcfe5033a5",
-    "@dxos/react-client": "0.8.4-main.fcfe5033a5",
-    "@dxos/react-ui": "0.8.4-main.fcfe5033a5",
-    "@dxos/react-ui-attention": "0.8.4-main.fcfe5033a5",
-    "@dxos/react-ui-form": "0.8.4-main.fcfe5033a5",
-    "@dxos/react-ui-mosaic": "0.8.4-main.fcfe5033a5",
-    "@dxos/react-ui-board": "0.8.4-main.fcfe5033a5",
-    "@dxos/react-ui-stack": "0.8.4-main.fcfe5033a5",
-    "@dxos/schema": "0.8.4-main.fcfe5033a5",
-    "@dxos/types": "0.8.4-main.fcfe5033a5",
-    "@dxos/util": "0.8.4-main.fcfe5033a5"
+    "@effect-atom/atom": "^0.5.3",
+    "@effect-atom/atom-react": "^0.5.0",
+    "effect": "3.21.3",
+    "@dxos/app-toolkit": "0.8.4-staging.60fe92afc8",
+    "@dxos/echo": "0.8.4-staging.60fe92afc8",
+    "@dxos/invariant": "0.8.4-staging.60fe92afc8",
+    "@dxos/app-framework": "0.8.4-staging.60fe92afc8",
+    "@dxos/echo-react": "0.8.4-staging.60fe92afc8",
+    "@dxos/keys": "0.8.4-staging.60fe92afc8",
+    "@dxos/plugin-client": "0.8.4-staging.60fe92afc8",
+    "@dxos/plugin-markdown": "0.8.4-staging.60fe92afc8",
+    "@dxos/plugin-space": "0.8.4-staging.60fe92afc8",
+    "@dxos/random": "0.8.4-staging.60fe92afc8",
+    "@dxos/compute": "0.8.4-staging.60fe92afc8",
+    "@dxos/react-client": "0.8.4-staging.60fe92afc8",
+    "@dxos/react-ui": "0.8.4-staging.60fe92afc8",
+    "@dxos/react-ui-board": "0.8.4-staging.60fe92afc8",
+    "@dxos/react-ui-stack": "0.8.4-staging.60fe92afc8",
+    "@dxos/types": "0.8.4-staging.60fe92afc8",
+    "@dxos/react-ui-attention": "0.8.4-staging.60fe92afc8",
+    "@dxos/react-ui-form": "0.8.4-staging.60fe92afc8",
+    "@dxos/util": "0.8.4-staging.60fe92afc8"
   },
   "devDependencies": {
     "@types/react": "~19.2.7",
     "@types/react-dom": "~19.2.3",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "vite": "^7.1.11",
-    "@dxos/plugin-preview": "0.8.4-main.fcfe5033a5",
-    "@dxos/plugin-testing": "0.8.4-main.fcfe5033a5",
-    "@dxos/plugin-theme": "0.8.4-main.fcfe5033a5",
-    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.fcfe5033a5",
-    "@dxos/storybook-utils": "0.8.4-main.fcfe5033a5",
-    "@dxos/test-utils": "0.8.4-main.fcfe5033a5",
-    "@dxos/ui-theme": "0.8.4-main.fcfe5033a5"
+    "vite": "^8.0.16",
+    "@dxos/plugin-preview": "0.8.4-staging.60fe92afc8",
+    "@dxos/plugin-testing": "0.8.4-staging.60fe92afc8",
+    "@dxos/plugin-theme": "0.8.4-staging.60fe92afc8",
+    "@dxos/react-ui-syntax-highlighter": "0.8.4-staging.60fe92afc8",
+    "@dxos/storybook-utils": "0.8.4-staging.60fe92afc8",
+    "@dxos/test-utils": "0.8.4-staging.60fe92afc8",
+    "@dxos/ui-theme": "0.8.4-staging.60fe92afc8"
   },
   "peerDependencies": {
-    "effect": "3.20.0",
+    "effect": "3.21.3",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "@dxos/react-ui": "0.8.4-main.fcfe5033a5",
-    "@dxos/ui-theme": "0.8.4-main.fcfe5033a5"
+    "@dxos/react-ui": "0.8.4-staging.60fe92afc8",
+    "@dxos/ui-theme": "0.8.4-staging.60fe92afc8"
   },
   "publishConfig": {
     "access": "public"

package/src/BoardPlugin.test.ts

@@ -0,0 +1,27 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { describe, test } from 'vitest';
+
+import { ClientPlugin } from '@dxos/plugin-client/plugin';
+import { createComposerTestApp } from '@dxos/plugin-testing/harness';
+
+import { BoardPlugin } from '#plugin';
+
+import { meta } from './meta';
+
+const moduleId = (name: string) => `${meta.id}.module.${name}`;
+
+describe('BoardPlugin', () => {
+  test('modules activate on the expected events', async ({ expect }) => {
+    await using harness = await createComposerTestApp({
+      plugins: [ClientPlugin({}), BoardPlugin()],
+    });
+
+    // Modules expected to be active after a normal startup.
+    expect(harness.manager.getActive()).toEqual(
+      expect.arrayContaining([moduleId('CreateObject'), moduleId('schema'), moduleId('ReactSurface')]),
+    );
+  });
+});

package/src/BoardPlugin.tsx

@@ -2,45 +2,27 @@
 // Copyright 2023 DXOS.org
 //
 
-import * as Effect from 'effect/Effect';
-import * as Option from 'effect/Option';
-
 import { Plugin } from '@dxos/app-framework';
 import { AppPlugin } from '@dxos/app-toolkit';
-import { Annotation } from '@dxos/echo';
-import { Operation } from '@dxos/operation';
-import { SpaceOperation } from '@dxos/plugin-space/operations';
-import { type CreateObject } from '@dxos/plugin-space/types';
-import { translations as boardTranslations } from '@dxos/react-ui-board';
+import { translations as boardTranslations } from '@dxos/react-ui-board/translations';
 
-import { ReactSurface } from '#capabilities';
+import { CreateObject, ReactSurface } from '#capabilities';
 import { meta } from '#meta';
+import { translations } from '#translations';
 import { Board } from '#types';
 
-import { translations } from './translations';
+// eslint-disable-next-line import/no-relative-packages
+import pluginSpec from '../PLUGIN.mdl?raw';
 
 export const BoardPlugin = Plugin.define(meta).pipe(
-  AppPlugin.addMetadataModule({
-    metadata: {
-      id: Board.Board.typename,
-      metadata: {
-        icon: Annotation.IconAnnotation.get(Board.Board).pipe(Option.getOrThrow).icon,
-        iconHue: Annotation.IconAnnotation.get(Board.Board).pipe(Option.getOrThrow).hue ?? 'white',
-        createObject: ((props, options) =>
-          Effect.gen(function* () {
-            const object = Board.makeBoard(props);
-            return yield* Operation.invoke(SpaceOperation.AddObject, {
-              object,
-              target: options.target,
-              hidden: true,
-              targetNodeId: options.targetNodeId,
-            });
-          })) satisfies CreateObject,
-      },
-    },
-  }),
+  AppPlugin.addCreateObjectModule({ activate: CreateObject }),
   AppPlugin.addSchemaModule({ schema: [Board.Board] }),
   AppPlugin.addSurfaceModule({ activate: ReactSurface }),
   AppPlugin.addTranslationsModule({ translations: [...translations, ...boardTranslations] }),
+  AppPlugin.addPluginAssetModule({
+    asset: { pluginId: meta.id, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },
+  }),
   Plugin.make,
 );
+
+export default BoardPlugin;

package/src/capabilities/create-object.ts

@@ -0,0 +1,31 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability } from '@dxos/app-framework';
+import { Operation } from '@dxos/compute';
+import { Type } from '@dxos/echo';
+import { SpaceOperation } from '@dxos/plugin-space';
+import { SpaceCapabilities } from '@dxos/plugin-space';
+
+import { Board } from '#types';
+
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    return Capability.contributes(SpaceCapabilities.CreateObjectEntry, {
+      id: Type.getTypename(Board.Board),
+      createObject: (props, options) =>
+        Effect.gen(function* () {
+          const object = Board.makeBoard(props);
+          return yield* Operation.invoke(SpaceOperation.AddObject, {
+            object,
+            target: options.target,
+            hidden: true,
+            targetNodeId: options.targetNodeId,
+          });
+        }),
+    });
+  }),
+);

package/src/capabilities/index.ts

@@ -4,4 +4,5 @@
 
 import { Capability } from '@dxos/app-framework';
 
+export const CreateObject = Capability.lazy('CreateObject', () => import('./create-object'));
 export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));

package/src/capabilities/react-surface.tsx

@@ -9,7 +9,7 @@ import { Capabilities, Capability } from '@dxos/app-framework';
 import { Surface } from '@dxos/app-framework/ui';
 import { AppSurface } from '@dxos/app-toolkit/ui';
 
-import { BoardContainer } from '#containers';
+import { BoardArticle } from '#containers';
 import { Board } from '#types';
 
 export default Capability.makeModule(() =>
@@ -23,7 +23,7 @@ export default Capability.makeModule(() =>
           AppSurface.object(AppSurface.Section, Board.Board),
         ),
         component: ({ role, data }) => (
-          <BoardContainer role={role} subject={data.subject} attendableId={data.attendableId} />
+          <BoardArticle role={role} subject={data.subject} attendableId={data.attendableId} />
         ),
       }),
     ]),

package/src/containers/{BoardContainer/BoardContainer.stories.tsx → BoardArticle/BoardArticle.stories.tsx}

@@ -7,21 +7,21 @@ import * as Effect from 'effect/Effect';
 import React, { useEffect, useState } from 'react';
 
 import { withPluginManager } from '@dxos/app-framework/testing';
-import { Obj } from '@dxos/echo';
-import { ClientPlugin } from '@dxos/plugin-client';
+import { Filter, Obj, Ref } from '@dxos/echo';
+import { ClientPlugin } from '@dxos/plugin-client/testing';
 import { initializeIdentity } from '@dxos/plugin-client/testing';
-import { PreviewPlugin } from '@dxos/plugin-preview';
+import { PreviewPlugin } from '@dxos/plugin-preview/testing';
 import { StorybookPlugin, corePlugins } from '@dxos/plugin-testing';
 import { random } from '@dxos/random';
-import { Filter, Ref, useQuery, useSpaces } from '@dxos/react-client/echo';
-import { translations as stackTranslations } from '@dxos/react-ui-stack';
+import { useQuery, useSpaces } from '@dxos/react-client/echo';
+import { translations as stackTranslations } from '@dxos/react-ui-stack/translations';
 import { withLayout } from '@dxos/react-ui/testing';
 import { Organization, Person } from '@dxos/types';
 
+import { translations } from '#translations';
 import { Board } from '#types';
 
-import { translations } from '../../translations';
-import { BoardContainer } from './BoardContainer';
+import { BoardArticle } from './BoardArticle';
 
 random.seed(0);
 
@@ -62,7 +62,7 @@ const DefaultStory = () => {
     return null;
   }
 
-  return <BoardContainer role='board' subject={board} attendableId='test' />;
+  return <BoardArticle role='board' subject={board} attendableId='test' />;
 };
 
 //
@@ -70,7 +70,7 @@ const DefaultStory = () => {
 //
 
 const meta = {
-  title: 'plugins/plugin-board/containers/BoardContainer',
+  title: 'plugins/plugin-board/containers/BoardArticle',
   render: DefaultStory,
   decorators: [
     withLayout({ layout: 'fullscreen' }),
@@ -86,7 +86,7 @@ const meta = {
               yield* Effect.promise(() => space.waitUntilReady());
               const board = space.db.add(createBoard());
 
-              Obj.change(board, (board) => {
+              Obj.update(board, (board) => {
                 // Add some sample items
                 Array.from({ length: 10 }).map(() => {
                   const org = createOrg();

package/src/containers/{BoardContainer/BoardContainer.tsx → BoardArticle/BoardArticle.tsx}

@@ -2,13 +2,17 @@
 // Copyright 2025 DXOS.org
 //
 
+import { useAtomValue } from '@effect-atom/atom-react';
+import * as Atom from '@effect-atom/atom/Atom';
 import React, { useCallback, useMemo, useRef, useState } from 'react';
 
 import { Surface } from '@dxos/app-framework/ui';
 import { AppSurface } from '@dxos/app-toolkit/ui';
 import { Filter, Obj, Ref } from '@dxos/echo';
-import { useObject, useObjects } from '@dxos/echo-react';
+import { useObject } from '@dxos/echo-react';
 import { invariant } from '@dxos/invariant';
+import { EID } from '@dxos/keys';
+import { Markdown } from '@dxos/plugin-markdown';
 import { useQuery } from '@dxos/react-client/echo';
 import { Panel } from '@dxos/react-ui';
 import { useAttention } from '@dxos/react-ui-attention';
@@ -24,17 +28,32 @@ type PickerState = {
   position: Position;
 };
 
-export type BoardContainerProps = AppSurface.ObjectArticleProps<BoardType.Board>;
+export type BoardArticleProps = AppSurface.ObjectArticleProps<BoardType.Board>;
 
-export const BoardContainer = ({ role, subject: board, attendableId }: BoardContainerProps) => {
-  const controller = useRef<BoardController>(null);
+export const BoardArticle = ({ role, subject: board, attendableId }: BoardArticleProps) => {
+  const { hasAttention } = useAttention(attendableId);
+  const db = Obj.getDatabase(board);
   const [boardItems] = useObject(board, 'items');
-  const items = useObjects(boardItems ?? []);
+  const itemsAtom = useMemo(
+    () =>
+      Atom.make((get) => {
+        const result: Obj.Unknown[] = [];
+        for (const ref of boardItems ?? []) {
+          const obj = get(Obj.atomReactive(ref));
+          if (obj) {
+            result.push(obj);
+          }
+        }
+        return result;
+      }),
+    [boardItems],
+  );
+  const items = useAtomValue(itemsAtom);
+
+  const controller = useRef<BoardController>(null);
   const addTriggerRef = useRef<HTMLButtonElement | null>(null);
   const [pickerState, setPickerState] = useState<PickerState | null>(null);
-  const { hasAttention } = useAttention(attendableId);
 
-  const db = Obj.getDatabase(board);
   // TODO(burdon): Use search.
   const objects = useQuery(db, Filter.everything());
   const options = useMemo<ObjectPickerContentProps['options']>(
@@ -57,13 +76,22 @@ export const BoardContainer = ({ role, subject: board, attendableId }: BoardCont
   );
 
   const handleAdd = useCallback<NonNullable<BoardRootProps['onAdd']>>(
-    async (anchor, position = DEFAULT_POSITION) => {
+    async (anchor, position) => {
       const db = Obj.getDatabase(board);
       invariant(db);
+      // Grid backdrop "+" supplies a position → create a new Markdown document directly.
+      // Toolbar "+" omits position → fall back to the picker over existing objects.
+      if (position) {
+        const doc = db.add(Markdown.make());
+        Obj.update(board, (board) => {
+          board.items.push(Ref.make(doc));
+          board.layout.cells[doc.id.toString()] = position;
+        });
+        return;
+      }
+
       addTriggerRef.current = anchor;
-      setPickerState({
-        position,
-      });
+      setPickerState({ position: DEFAULT_POSITION });
     },
     [board],
   );
@@ -72,8 +100,11 @@ export const BoardContainer = ({ role, subject: board, attendableId }: BoardCont
   const handleDelete = useCallback<NonNullable<BoardRootProps['onDelete']>>(
     (id) => {
       // TODO(burdon): Impl. DXN.equals and pass in DXN from `id`.
-      const idx = board.items.findIndex((ref) => ref.dxn.asEchoDXN()?.echoId === id);
-      Obj.change(board, (board) => {
+      const idx = board.items.findIndex((ref) => {
+        const echoUri = EID.tryParse(ref.uri);
+        return (echoUri ? EID.getEntityId(echoUri) : undefined) === id;
+      });
+      Obj.update(board, (board) => {
         if (idx !== -1) {
           board.items.splice(idx, 1);
         }
@@ -86,7 +117,7 @@ export const BoardContainer = ({ role, subject: board, attendableId }: BoardCont
   const handleMove = useCallback<NonNullable<BoardRootProps['onMove']>>(
     (id, position) => {
       const layout = board.layout.cells[id];
-      Obj.change(board, (board) => {
+      Obj.update(board, (board) => {
         board.layout.cells[id] = { ...layout, ...position };
       });
     },
@@ -106,7 +137,7 @@ export const BoardContainer = ({ role, subject: board, attendableId }: BoardCont
       }
 
       // Create a reference to the selected object and add it to the board.
-      Obj.change(board, (board) => {
+      Obj.update(board, (board) => {
         board.items.push(Ref.make(selectedObject));
 
         // Set the layout position for the new item.
@@ -138,7 +169,7 @@ export const BoardContainer = ({ role, subject: board, attendableId }: BoardCont
                 <Board.Content>
                   {items?.map((item, index) => (
                     <Board.Cell item={item} key={index} layout={board.layout?.cells[item.id] ?? { x: 0, y: 0 }}>
-                      <Surface.Surface type={AppSurface.Card} data={{ subject: item }} limit={1} />
+                      <Surface.Surface type={AppSurface.Card} data={{ subject: item, editable: true }} limit={1} />
                     </Board.Cell>
                   ))}
                 </Board.Content>

package/src/containers/BoardArticle/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+export { BoardArticle as default } from './BoardArticle';

package/src/containers/index.ts

@@ -4,4 +4,4 @@
 
 import { type ComponentType, lazy } from 'react';
 
-export const BoardContainer: ComponentType<any> = lazy(() => import('./BoardContainer'));
+export const BoardArticle: ComponentType<any> = lazy(() => import('./BoardArticle'));

package/src/index.ts

@@ -4,5 +4,3 @@
 
 export * from './meta';
 export * from './types';
-
-export * from './BoardPlugin';

package/src/meta.ts

@@ -2,18 +2,28 @@
 // Copyright 2023 DXOS.org
 //
 
-import { type Plugin } from '@dxos/app-framework';
+import { Plugin } from '@dxos/app-framework';
+import { DXN } from '@dxos/keys';
 import { trim } from '@dxos/util';
 
-export const meta: Plugin.Meta = {
-  id: 'org.dxos.plugin.board',
+export const meta = Plugin.makeMeta({
+  key: DXN.make('org.dxos.plugin.board'),
   name: 'Board',
+  author: 'DXOS',
   description: trim`
-    Infinite canvas workspace that combines sticky notes, media, and whiteboarding tools.
-    Arrange and connect ideas freely in a visual space perfect for brainstorming and creative collaboration.
+    Board is an infinite spatial canvas that lets you place any ECHO object — documents, tasks, notes, or rich media — anywhere on a two-dimensional grid.
+    Items are arranged by dragging, resized freely, and removed from the canvas without deleting the underlying data, so the same object can appear on multiple boards simultaneously.
+
+    Each board is itself an ECHO object, making it fully collaborative and conflict-free: all participants see live updates as peers add, move, or remove items in real time.
+    The canvas scales to any resolution, supports nested surfaces through the Composer slot system, and integrates naturally with other plugins via the shared ObjectPicker.
+
+    Board is designed as a lightweight composition layer: it imposes no schema on the objects it hosts and delegates rendering to each object's own Card surface, so every plugin contributes its own card representation automatically.
+    This makes it ideal for dashboards, mood boards, project overviews, or any context where spatial relationships between heterogeneous objects carry meaning.
   `,
   icon: 'ph--squares-four--regular',
   iconHue: 'green',
   source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-board',
+  spec: 'PLUGIN.mdl',
   screenshots: [],
-};
+  tags: ['labs'],
+});

package/src/plugin.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Plugin } from '@dxos/app-framework';
+
+import { meta } from './meta';
+
+export const BoardPlugin = Plugin.lazy(meta, () => import('#plugin'));

package/src/translations.ts

@@ -2,6 +2,7 @@
 // Copyright 2023 DXOS.org
 //
 
+import { Type } from '@dxos/echo';
 import { type Resource } from '@dxos/react-ui';
 
 import { meta } from '#meta';
@@ -10,7 +11,7 @@ import { Board } from '#types';
 export const translations = [
   {
     'en-US': {
-      [Board.Board.typename]: {
+      [Type.getTypename(Board.Board)]: {
         'typename.label': 'Board',
         'typename.label_zero': 'Boards',
         'typename.label_one': 'Board',

package/src/types/Board.ts

@@ -4,8 +4,8 @@
 
 import * as Schema from 'effect/Schema';
 
-import { Annotation, Obj, Ref, Type } from '@dxos/echo';
-import { FormInputAnnotation, LabelAnnotation } from '@dxos/echo/internal';
+import { DXN, Annotation, Obj, Ref, Type } from '@dxos/echo';
+import { FormInputAnnotation, LabelAnnotation } from '@dxos/echo/Annotation';
 import { BoardLayout, defaultLayout } from '@dxos/react-ui-board';
 
 /**
@@ -16,18 +16,12 @@ export const Board = Schema.Struct({
   items: Ref.Ref(Obj.Unknown).pipe(Schema.Array, FormInputAnnotation.set(false)),
   layout: BoardLayout.pipe(FormInputAnnotation.set(false)),
 }).pipe(
-  Type.object({
-    typename: 'org.dxos.type.board',
-    version: '0.1.0',
-  }),
   LabelAnnotation.set(['name']),
-  Annotation.IconAnnotation.set({
-    icon: 'ph--squares-four--regular',
-    hue: 'green',
-  }),
+  Annotation.IconAnnotation.set({ icon: 'ph--squares-four--regular', hue: 'green' }),
+  Type.makeObject(DXN.make('org.dxos.type.board', '0.1.0')),
 );
 
-export interface Board extends Schema.Schema.Type<typeof Board> {}
+export type Board = Type.InstanceType<typeof Board>;
 
 export const makeBoard = (props: Partial<Obj.MakeProps<typeof Board>> = {}) =>
   Obj.make(Board, {

package/src/vite-env.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="vite/client" />
+
+//
+// Copyright 2026 DXOS.org
+//
+
+declare module '*.mdl?raw' {
+  const content: string;
+  export default content;
+}