an exclusionary rule, made structural. a plugin does not render a screen: it
contributes panels and says how they are arranged, and the shell renders
WorkspaceView around them.
web/panels.ts appRegistryMetas — at least one panel
web/layout.ts defaultLayout — how they are arranged
both required the moment web/ exists, and missing either is refused at discovery
by name and with the reason. tested:
probeplug: has a web/ directory but is missing web/layout.ts.
Every plugin route renders a Workspace: contribute panels and a layout,
not a screen.
there is deliberately no way to export a component. one that could would be free
to render a bare div, a full-page form, or its own navigation, and the platform
would become a shell hosting strangers' layouts rather than one application.
non-compliance is not so much refused as unrepresentable — there is nowhere to
put a screen.
the shell registers <prefix> and <prefix>/:section, exactly as the core screens
do, so a plugin's sections stay addressable and cmd-clickable, and panels read
useParams independently rather than passing state between themselves.
appTypes.allowed is pinned to that plugin's own keys, so a persisted layout
naming something else falls back instead of rendering another plugin's panel
inside this screen.
the example plugin is rebuilt to model it — two panels, a layout, one of them
calling its own /api/example/ping through useClient — because the reference
implementation is what everyone copies.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
60 lines
2.9 KiB
HTML
60 lines
2.9 KiB
HTML
<!doctype html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" />
|
|
<title>Officer Dev (Alpha)</title>
|
|
<meta
|
|
name="description"
|
|
content="Your all-purpose AI operating system. Personal AI assistant, terminal, file browser, code editor, and customizable dashboards — all self-hosted."
|
|
/>
|
|
|
|
<!-- OpenGraph. Crawlers fetch these standalone, so they need absolute URLs. __PUBLIC_URL__ is
|
|
substituted from .env by scripts/gen-index.ts into index.gen.html, which is what the server
|
|
actually serves — this file is the template and stays identical across deployments. -->
|
|
<!-- OpenGraph -->
|
|
<meta property="og:type" content="website" />
|
|
<meta property="og:title" content="Officer Dev (Alpha)" />
|
|
<meta
|
|
property="og:description"
|
|
content="Your all-purpose AI operating system. Personal AI assistant, terminal, file browser, code editor, and customizable dashboards — all self-hosted."
|
|
/>
|
|
<meta property="og:image" content="__PUBLIC_URL__/og-image-v3.jpg" />
|
|
<meta property="og:image:secure_url" content="__PUBLIC_URL__/og-image-v3.jpg" />
|
|
<meta property="og:image:width" content="1200" />
|
|
<meta property="og:image:height" content="630" />
|
|
<meta property="og:image:type" content="image/jpeg" />
|
|
<meta property="og:url" content="__PUBLIC_URL__" />
|
|
<meta property="og:site_name" content="Officer Dev" />
|
|
|
|
<!-- Twitter Card -->
|
|
<meta name="twitter:card" content="summary_large_image" />
|
|
<meta name="twitter:title" content="Officer Dev (Alpha)" />
|
|
<meta
|
|
name="twitter:description"
|
|
content="Your all-purpose AI operating system. Personal AI assistant, terminal, file browser, code editor, and customizable dashboards — all self-hosted."
|
|
/>
|
|
<meta name="twitter:image" content="__PUBLIC_URL__/og-image-v3.jpg" />
|
|
|
|
<!-- Favicons & App Icons. These must stay absolute: Bun's HTML bundler treats a root-relative
|
|
href as an asset to resolve on disk and fails the build ("Could not resolve: /favicon.ico"),
|
|
whereas external URLs are passed through untouched. Substituting PUBLIC_URL also keeps the
|
|
manifest same-origin, so its CORS-mode fetch succeeds. -->
|
|
<link rel="icon" type="image/x-icon" href="__PUBLIC_URL__/favicon.ico" />
|
|
<link rel="icon" type="image/png" sizes="96x96" href="__PUBLIC_URL__/favicon-96x96.png" />
|
|
<link rel="apple-touch-icon" sizes="180x180" href="__PUBLIC_URL__/apple-touch-icon.png" />
|
|
<link rel="manifest" href="__PUBLIC_URL__/site.webmanifest" />
|
|
<meta name="theme-color" content="#1F2620" />
|
|
|
|
<script src="https://cdn.jsdelivr.net/npm/eruda"></script>
|
|
<script>
|
|
eruda.init();
|
|
eruda._entryBtn.hide();
|
|
</script>
|
|
<script type="module" src="./frontend.tsx" async></script>
|
|
</head>
|
|
<body>
|
|
<div id="root"></div>
|
|
</body>
|
|
</html>
|