update idea cards app

Author: KaimingTao

Makefile

@@ -3,7 +3,7 @@
 ## Project Structure & Module Organization
 - `index.html` is the entry point; it loads the responsive card grid and modal logic.
 - `src/` holds modular scripts (`src/cards.js`, `src/modal.js`) and shared utilities.
-- `data/cards.json` stores card metadata (`id`, `title`, `summary`, `details`, `tags`).
+- `../data/cards.md` stores card metadata (`title`, `summary`, `details`, `tags`).
 - `assets/styles/` contains compiled CSS; author SCSS in `assets/styles/scss/`.
 - `assets/images/` keeps optimized `.webp` thumbnails referenced by card entries.
 - `docs/` mirrors the production-ready bundle pushed to GitHub Pages (built from `dist/`).
@@ -33,6 +33,6 @@
 - Ensure `npm run lint` and relevant tests pass; update `docs/` from the latest `dist/` before merging.
 
 ## Content Workflow
-- Add new cards via `data/cards.json`, keeping body text Markdown-friendly for future parsing.
+- Add new cards via `../data/cards.md`, keeping body text Markdown-friendly for future parsing.
 - Store supporting assets under `assets/images/` and reference them in the card entry.
 - Validate copy for accessibility (clear titles, concise summaries) and include `alt` text for every image.

app/AGENTS.md

@@ -5,7 +5,7 @@
   "type": "module",
   "scripts": {
     "dev": "vite",
-    "build": "vite build && cpy data dist/data --recursive",
+    "build": "vite build && rimraf dist/data && cpy ../data dist --recursive",
     "preview": "vite preview",
     "lint": "npm run lint:js && npm run lint:css && npm run lint:format",
     "lint:js": "eslint \"src/**/*.{js,jsx}\" \"tests/**/*.js\" --max-warnings=0",

app/package.json

@@ -4,7 +4,7 @@ let cardsCache = null;
 
 const cardsRequestUrl = (() => {
   try {
-    return new URL('../data/cards.md', import.meta.url).href;
+    return new URL('../../data/cards.md', import.meta.url).href;
   } catch (error) {
     console.warn('Unable to resolve cards.md via import.meta.url, falling back to relative path', error);
     return 'data/cards.md';
@@ -292,8 +292,12 @@ function loadFromBundle() {
   }
 
   try {
-    const modules = import.meta.glob('../data/cards.md', { eager: true, as: 'raw' });
-    const module = modules['../data/cards.md'];
+    const modules = import.meta.glob('../../data/cards.md', {
+      eager: true,
+      import: 'default',
+      query: '?raw',
+    });
+    const module = modules['../../data/cards.md'];
     if (!module) {
       return null;
     }

app/src/cards.js

@@ -1,5 +1,8 @@
 import { defineConfig } from 'vite';
 import { resolve } from 'node:path';
+
+const workspaceRoot = resolve(__dirname, '..');
+
 export default defineConfig({
   root: '.',
   base: './',
@@ -10,6 +13,9 @@ export default defineConfig({
   },
   server: {
     open: true,
+    fs: {
+      allow: [workspaceRoot, __dirname],
+    },
   },
   preview: {
     open: true,