pindeck 2.8.1 → 2.8.2

package/README.md

@@ -1,5 +1,7 @@
 # PinDeck
 
+> **macOS only.** Windows and Linux are not supported.
+
 **Pin it. Say it. Done.** PinDeck is a local editor for HTML slide decks (reveal.js): the slides on
 the left, the slide in the middle, and a chat with Claude Code on the right. You click elements to
 pin them, write what to change, and Claude edits the HTML and CSS. The slide updates in place.
@@ -26,6 +28,10 @@ checked the layout; the next request, still being typed, refers to the new pins
 
 ## Quick start
 
+Requires macOS. The npm package declares `"os": ["darwin"]`, so normal npm installation
+rejects other operating systems. Overriding that check does not make those platforms supported. Running the server from a cloned
+repository on another OS shows a local support notice instead of opening the deck or starting Claude.
+
 ```bash
 npx pindeck path/to/deck        # from npm
 
@@ -249,6 +255,10 @@ Without PowerPoint or Keynote (or on other systems than macOS) only the text and
 
 ## Versions
 
+* **2.8.2**: declares macOS-only support in npm metadata and the README to prevent accidental
+  installation on unsupported operating systems. Source launches on other platforms show a support
+  notice without opening the deck.
+
 * **2.8.1**: fixes from a review. Speaker notes that fail to load leave the field empty and locked, instead
   of showing the previous slide's notes and saving your edits over them. A save that fails because the
   server cannot be reached is reported, and the edits after it (drags, text, bullets, notes) are still

package/lib/platform-notice.mjs

@@ -0,0 +1,34 @@
+import http from 'node:http';
+
+export function createPlatformNoticeServer(platform) {
+  const windows = platform === 'win32';
+  const heading = windows ? 'Windows support is on the roadmap' : 'PinDeck currently requires macOS';
+  const explanation = windows
+    ? 'PinDeck is currently available for macOS only. Windows support is planned for a future version; there is no release date yet.'
+    : 'This version of PinDeck supports macOS only. Linux and other operating systems are not supported yet.';
+  const html = `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>PinDeck · macOS required</title><style>
+  :root{font-family:system-ui,sans-serif;color:#243348;background:#f4f6f8;color-scheme:light}*{box-sizing:border-box}body{margin:0;min-height:100vh;display:grid;place-items:center;padding:24px}main{width:min(100%,620px);padding:40px;background:white;border:1px solid #dde3ea;border-radius:18px;box-shadow:0 12px 40px #20334d0a}.brand{font-weight:700;color:#c36516;margin:0 0 32px}h1{font-size:clamp(26px,5vw,36px);line-height:1.2;margin:0 0 20px}p{line-height:1.65}a{color:#945012}footer{margin-top:28px;font-size:14px;color:#596577}
+  </style></head><body><main><p class="brand">PinDeck</p><h1>${heading}</h1><p>${explanation}</p><p>Your deck has not been opened or changed, and no AI backend has been started.</p><p>You can use PinDeck on a Mac or follow updates on <a href="https://github.com/ehabets/PinDeck">GitHub</a>.</p><footer>Close this tab and press Ctrl+C in the terminal to stop this notice.</footer></main></body></html>`;
+  return http.createServer((req, res) => {
+    if (req.method !== 'GET' && req.method !== 'HEAD') { res.writeHead(405, { Allow: 'GET, HEAD' }); return res.end(); }
+    res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8', 'Cache-Control': 'no-store',
+      'Content-Security-Policy': "default-src 'none'; style-src 'unsafe-inline'; base-uri 'none'; frame-ancestors 'none'" });
+    res.end(req.method === 'HEAD' ? undefined : html);
+  });
+}
+
+// Keep startup here until the notice is closed: no deck/state initialization runs on unsupported OSes.
+export async function showPlatformNotice(port, platform = process.platform) {
+  const server = createPlatformNoticeServer(platform);
+  await new Promise((resolve, reject) => {
+    const stop = () => server.close();
+    server.once('error', reject);
+    server.once('close', () => {
+      process.off('SIGINT', stop); process.off('SIGTERM', stop); resolve();
+    });
+    server.listen(port, '127.0.0.1', () => {
+      process.once('SIGINT', stop); process.once('SIGTERM', stop);
+      console.log(`PinDeck requires macOS. Open http://127.0.0.1:${server.address().port}/ for details. Press Ctrl+C to stop.`);
+    });
+  });
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pindeck",
-  "version": "2.8.1",
-  "description": "PinDeck: a local editor for HTML slide decks. Pin elements, describe the change, and Claude Code edits the slides.",
+  "version": "2.8.2",
+  "description": "PinDeck: a local macOS editor for HTML slide decks. Pin elements, describe the change, and Claude Code edits the slides.",
   "keywords": [
     "slides",
     "presentation",
@@ -35,6 +35,7 @@
     "start": "node server.mjs",
     "test": "node --test"
   },
+  "os": ["darwin"],
   "engines": {
     "node": ">=20"
   }

package/server.mjs

@@ -41,6 +41,11 @@ const argv = process.argv.slice(2);
 if (argv.includes("--help") || argv.includes("-h")) { console.log(USAGE); process.exit(0); }
 const opt = (name, dflt) => { const i = argv.indexOf(name); return i >= 0 ? argv.splice(i, 2)[1] : dflt; };
 const PORT = +opt("--port", process.env.PORT || 5180);
+if (process.platform !== "darwin") {
+  const { showPlatformNotice } = await import("./lib/platform-notice.mjs");
+  await showPlatformNotice(PORT);
+  process.exit(0);
+}
 const MODEL = opt("--model", process.env.CLAUDE_MODEL || "");
 const DECK_DIR = path.resolve(argv[0] || process.cwd());
 const DECK_FILE = "index.html";