kanbanqube 1.0.7 → 1.0.9

package/README.md

@@ -7,7 +7,7 @@
 
 ![KanbanQube preview](promo.jpg)
 
-KanbanQube is a local-first Kanban board app backed by normal files in a vault folder. It is designed for personal or team workflows where the board should live in a regular directory, optionally inside a Git repository, so changes can be versioned and synced with the tools you already use.
+KanbanQube is a local-first Kanban board app for solo users and very small teams. A board lives as normal files in a regular vault folder on your machine and can optionally be placed inside a Git repository, so changes can be versioned and synced with tools you already use.
 
 The app provides lanes, cards, labels, checklists, comments, card covers, file attachments, archived cards, search, and a card-detail view. Uploaded files are stored in an `uploads/` folder, while board data is split into per-object JSON files under `board/` so Git can merge independent card and checklist edits more cleanly.
 

package/controllers/importController.js

@@ -12,8 +12,20 @@ function createImportController(boardService, importService) {
     response.json(await boardService.saveBoard(importedBoard));
   }
 
+  async function importDemoBoard(_request, response) {
+    const currentBoard = await boardService.loadBoard();
+    if ((currentBoard.cards || []).length > 0) {
+      response.status(409).json({ error: "Demo board can only be loaded when the board has no cards." });
+      return;
+    }
+
+    const demoBoard = await importService.readDemoBoard();
+    response.json(await boardService.saveBoard(demoBoard));
+  }
+
   return {
-    importBoard
+    importBoard,
+    importDemoBoard
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kanbanqube",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Local-first Kanban board backed by normal files",
   "license": "Apache-2.0",
   "author": "Mathias Conradt",

package/public/app.js

@@ -217,11 +217,14 @@ function isBoardEmpty() {
 }
 
 async function loadDemoBoard() {
-  const response = await fetch(DEMO_BOARD_PATH);
+  const response = await fetch("/api/demo-board", {
+    method: "POST"
+  });
+  const payload = await response.json();
   if (!response.ok) {
-    throw new Error("Could not load demo board.");
+    throw new Error(payload.error || "Could not load demo board.");
   }
-  return response.json();
+  return payload;
 }
 
 function wireEvents() {

package/routes/apiRoutes.js

@@ -22,6 +22,7 @@ function createApiRoutes(services) {
   router.post("/uploads", asyncHandler(uploadController.uploadFiles));
   router.delete("/uploads/:fileName", asyncHandler(uploadController.deleteUpload));
   router.post("/import", asyncHandler(importController.importBoard));
+  router.post("/demo-board", asyncHandler(importController.importDemoBoard));
   router.post("/sync", asyncHandler(syncController.syncBoard));
   router.get("/sync-status", syncController.syncStatus);
 

package/services/importService.js

@@ -1,11 +1,13 @@
 "use strict";
 
+const fs = require("node:fs/promises");
 const { multipartBoundary, parseMultipartBody } = require("../utils/multipart");
 const { readBody } = require("../utils/requestBody");
 
-function createImportService() {
+function createImportService(config = {}) {
   return {
-    readImportedBoard
+    readImportedBoard,
+    readDemoBoard: () => readDemoBoard(config)
   };
 }
 
@@ -23,7 +25,15 @@ async function readImportedBoard(request) {
   return request.body && typeof request.body === "object" ? request.body : {};
 }
 
+async function readDemoBoard(config) {
+  if (!config.demoBoardFilePath) {
+    throw new Error("Demo board is not available.");
+  }
+  return JSON.parse(await fs.readFile(config.demoBoardFilePath, "utf8"));
+}
+
 module.exports = {
   createImportService,
-  readImportedBoard
+  readImportedBoard,
+  readDemoBoard
 };