lean-spec 0.2.5-dev.20251124050427 → 0.2.5-dev.20251124054449

package/dist/cli.js

@@ -1,4 +1,4 @@
-import { analyzeCommand, archiveCommand, backfillCommand, boardCommand, checkCommand, compactCommand, createCommand, depsCommand, examplesCommand, filesCommand, ganttCommand, initCommand, linkCommand, listCommand, mcpCommand, migrateCommand, openCommand, searchCommand, splitCommand, statsCommand, templatesCommand, timelineCommand, tokensCommand, uiCommand, unlinkCommand, updateCommand, validateCommand, viewCommand } from './chunk-YKBICZNR.js';
+import { analyzeCommand, archiveCommand, backfillCommand, boardCommand, checkCommand, compactCommand, createCommand, depsCommand, examplesCommand, filesCommand, ganttCommand, initCommand, linkCommand, listCommand, mcpCommand, migrateCommand, openCommand, searchCommand, splitCommand, statsCommand, templatesCommand, timelineCommand, tokensCommand, uiCommand, unlinkCommand, updateCommand, validateCommand, viewCommand } from './chunk-6FKLWECL.js';
 import './chunk-LVD7ZAVZ.js';
 import { Command } from 'commander';
 import { readFileSync } from 'fs';
@@ -93,7 +93,7 @@ Command Groups:
 Examples:
   $ lean-spec init
   $ lean-spec init -y
-  $ lean-spec init --example email-notifications
+  $ lean-spec init --example dark-theme
   $ lean-spec init --example dashboard-widgets --name my-demo
   $ lean-spec examples
   $ lean-spec create my-feature --priority high

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/commands/registry.ts","../src/cli.ts"],"names":["program"],"mappings":"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","file":"cli.js","sourcesContent":["import { Command } from 'commander';\nimport {\n  analyzeCommand,\n  archiveCommand,\n  backfillCommand,\n  boardCommand,\n  checkCommand,\n  compactCommand,\n  createCommand,\n  depsCommand,\n  examplesCommand,\n  filesCommand,\n  ganttCommand,\n  initCommand,\n  linkCommand,\n  listCommand,\n  mcpCommand,\n  migrateCommand,\n  openCommand,\n  searchCommand,\n  splitCommand,\n  statsCommand,\n  templatesCommand,\n  timelineCommand,\n  tokensCommand,\n  uiCommand,\n  unlinkCommand,\n  updateCommand,\n  validateCommand,\n  viewCommand,\n} from './index.js';\n\n/**\n * Register all commands in alphabetical order\n */\nexport function registerCommands(program: Command): void {\n  // Alphabetically sorted command registration\n  program.addCommand(analyzeCommand());\n  program.addCommand(archiveCommand());\n  program.addCommand(backfillCommand());\n  program.addCommand(boardCommand());\n  program.addCommand(checkCommand());\n  program.addCommand(compactCommand());\n  program.addCommand(createCommand());\n  program.addCommand(depsCommand());\n  program.addCommand(examplesCommand());\n  program.addCommand(filesCommand());\n  program.addCommand(ganttCommand());\n  program.addCommand(initCommand());\n  program.addCommand(linkCommand());\n  program.addCommand(listCommand());\n  program.addCommand(mcpCommand());\n  program.addCommand(migrateCommand());\n  program.addCommand(openCommand());\n  program.addCommand(searchCommand());\n  program.addCommand(splitCommand());\n  program.addCommand(statsCommand());\n  program.addCommand(templatesCommand());\n  program.addCommand(timelineCommand());\n  program.addCommand(tokensCommand());\n  program.addCommand(uiCommand());\n  program.addCommand(unlinkCommand());\n  program.addCommand(updateCommand());\n  program.addCommand(validateCommand());\n  program.addCommand(viewCommand());\n}\n","import { Command } from 'commander';\nimport { readFileSync } from 'fs';\nimport { fileURLToPath } from 'url';\nimport { dirname, join } from 'path';\nimport { registerCommands } from './commands/registry.js';\n\n// Get version from package.json\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\nconst packageJson = JSON.parse(\n  readFileSync(join(__dirname, '../package.json'), 'utf-8')\n);\n\nconst program = new Command();\n\nprogram\n  .name('lean-spec')\n  .description('Manage LeanSpec documents')\n  .version(packageJson.version);\n\n// Add custom help text with grouped commands\nprogram.addHelpText('after', `\nCommand Groups:\n\n  Core Workflow:\n    archive <spec>                Move spec to archived/\n    backfill [specs...]           Backfill timestamps from git history\n    create <name>                 Create new spec\n    examples                      List example projects for tutorials\n    init                          Initialize LeanSpec in current directory\n    link <spec>                   Add relationships between specs\n    migrate <input-path>          Migrate specs from other SDD tools\n    unlink <spec>                 Remove relationships between specs\n    update <spec>                 Update spec metadata\n    \n  Discovery & Search:\n    files <spec>                  List files in a spec\n    list                          List all specs\n    open <spec>                   Open spec in editor\n    search <query>                Full-text search with metadata filters\n    view <spec>                   View spec content\n    \n  Project Analytics:\n    board                         Show Kanban-style board view\n    deps <spec>                   Show dependency graph for a spec\n    gantt                         Show timeline with dependencies\n    stats                         Show aggregate statistics\n    timeline                      Show creation/completion over time\n    \n  Quality & Optimization:\n    analyze <spec>                Analyze spec complexity and structure\n    check                         Check for sequence conflicts\n    tokens [spec]                 Count tokens for LLM context management\n    validate [specs...]           Validate specs for quality issues\n    \n  Advanced Editing:\n    compact <spec>                Remove specified line ranges from spec\n    split <spec>                  Split spec into multiple files\n    \n  Configuration:\n    templates                     Manage spec templates\n    \n  Integration:\n    mcp                           Start MCP server for AI assistants\n    ui                            Start local web UI for spec management\n\nExamples:\n  $ lean-spec init\n  $ lean-spec init -y\n  $ lean-spec init --example email-notifications\n  $ lean-spec init --example dashboard-widgets --name my-demo\n  $ lean-spec examples\n  $ lean-spec create my-feature --priority high\n  $ lean-spec list --status in-progress\n  $ lean-spec view 042\n  $ lean-spec link 085 --depends-on 042,035\n  $ lean-spec link 085 --related 082\n  $ lean-spec unlink 085 --depends-on 042\n  $ lean-spec deps 085\n  $ lean-spec backfill --dry-run\n  $ lean-spec migrate ./docs/adr\n  $ lean-spec migrate ./docs/rfcs --with copilot\n  $ lean-spec board --tag backend\n  $ lean-spec search \"authentication\"\n  $ lean-spec validate\n  $ lean-spec tokens 059\n  $ lean-spec analyze 045 --json\n  $ lean-spec split 045 --output README.md:1-150 --output DESIGN.md:151-end\n  $ lean-spec ui\n  $ lean-spec ui --port 3001 --no-open\n  $ lean-spec ui --specs ./docs/specs --dry-run\n`);\n\n// Register all commands (alphabetically ordered)\nregisterCommands(program);\n\n// Parse and execute\nprogram.parse();\n"]}
+{"version":3,"sources":["../src/commands/registry.ts","../src/cli.ts"],"names":["program"],"mappings":";;;;;;;;AAmCO,SAAS,iBAAiBA,QAAAA,EAAwB;AAEvD,EAAAA,QAAAA,CAAQ,UAAA,CAAW,cAAA,EAAgB,CAAA;AACnC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,cAAA,EAAgB,CAAA;AACnC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,eAAA,EAAiB,CAAA;AACpC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,YAAA,EAAc,CAAA;AACjC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,YAAA,EAAc,CAAA;AACjC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,cAAA,EAAgB,CAAA;AACnC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,aAAA,EAAe,CAAA;AAClC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,WAAA,EAAa,CAAA;AAChC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,eAAA,EAAiB,CAAA;AACpC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,YAAA,EAAc,CAAA;AACjC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,YAAA,EAAc,CAAA;AACjC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,WAAA,EAAa,CAAA;AAChC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,WAAA,EAAa,CAAA;AAChC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,WAAA,EAAa,CAAA;AAChC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,UAAA,EAAY,CAAA;AAC/B,EAAAA,QAAAA,CAAQ,UAAA,CAAW,cAAA,EAAgB,CAAA;AACnC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,WAAA,EAAa,CAAA;AAChC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,aAAA,EAAe,CAAA;AAClC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,YAAA,EAAc,CAAA;AACjC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,YAAA,EAAc,CAAA;AACjC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,gBAAA,EAAkB,CAAA;AACrC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,eAAA,EAAiB,CAAA;AACpC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,aAAA,EAAe,CAAA;AAClC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,SAAA,EAAW,CAAA;AAC9B,EAAAA,QAAAA,CAAQ,UAAA,CAAW,aAAA,EAAe,CAAA;AAClC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,aAAA,EAAe,CAAA;AAClC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,eAAA,EAAiB,CAAA;AACpC,EAAAA,QAAAA,CAAQ,UAAA,CAAW,WAAA,EAAa,CAAA;AAClC;;;AC1DA,IAAM,UAAA,GAAa,aAAA,CAAc,MAAA,CAAA,IAAA,CAAY,GAAG,CAAA;AAChD,IAAM,SAAA,GAAY,QAAQ,UAAU,CAAA;AACpC,IAAM,cAAc,IAAA,CAAK,KAAA;AAAA,EACvB,YAAA,CAAa,IAAA,CAAK,SAAA,EAAW,iBAAiB,GAAG,OAAO;AAC1D,CAAA;AAEA,IAAM,OAAA,GAAU,IAAI,OAAA,EAAQ;AAE5B,OAAA,CACG,IAAA,CAAK,WAAW,CAAA,CAChB,WAAA,CAAY,2BAA2B,CAAA,CACvC,OAAA,CAAQ,YAAY,OAAO,CAAA;AAG9B,OAAA,CAAQ,YAAY,OAAA,EAAS;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAsE5B,CAAA;AAGD,gBAAA,CAAiB,OAAO,CAAA;AAGxB,OAAA,CAAQ,KAAA,EAAM","file":"cli.js","sourcesContent":["import { Command } from 'commander';\nimport {\n  analyzeCommand,\n  archiveCommand,\n  backfillCommand,\n  boardCommand,\n  checkCommand,\n  compactCommand,\n  createCommand,\n  depsCommand,\n  examplesCommand,\n  filesCommand,\n  ganttCommand,\n  initCommand,\n  linkCommand,\n  listCommand,\n  mcpCommand,\n  migrateCommand,\n  openCommand,\n  searchCommand,\n  splitCommand,\n  statsCommand,\n  templatesCommand,\n  timelineCommand,\n  tokensCommand,\n  uiCommand,\n  unlinkCommand,\n  updateCommand,\n  validateCommand,\n  viewCommand,\n} from './index.js';\n\n/**\n * Register all commands in alphabetical order\n */\nexport function registerCommands(program: Command): void {\n  // Alphabetically sorted command registration\n  program.addCommand(analyzeCommand());\n  program.addCommand(archiveCommand());\n  program.addCommand(backfillCommand());\n  program.addCommand(boardCommand());\n  program.addCommand(checkCommand());\n  program.addCommand(compactCommand());\n  program.addCommand(createCommand());\n  program.addCommand(depsCommand());\n  program.addCommand(examplesCommand());\n  program.addCommand(filesCommand());\n  program.addCommand(ganttCommand());\n  program.addCommand(initCommand());\n  program.addCommand(linkCommand());\n  program.addCommand(listCommand());\n  program.addCommand(mcpCommand());\n  program.addCommand(migrateCommand());\n  program.addCommand(openCommand());\n  program.addCommand(searchCommand());\n  program.addCommand(splitCommand());\n  program.addCommand(statsCommand());\n  program.addCommand(templatesCommand());\n  program.addCommand(timelineCommand());\n  program.addCommand(tokensCommand());\n  program.addCommand(uiCommand());\n  program.addCommand(unlinkCommand());\n  program.addCommand(updateCommand());\n  program.addCommand(validateCommand());\n  program.addCommand(viewCommand());\n}\n","import { Command } from 'commander';\nimport { readFileSync } from 'fs';\nimport { fileURLToPath } from 'url';\nimport { dirname, join } from 'path';\nimport { registerCommands } from './commands/registry.js';\n\n// Get version from package.json\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\nconst packageJson = JSON.parse(\n  readFileSync(join(__dirname, '../package.json'), 'utf-8')\n);\n\nconst program = new Command();\n\nprogram\n  .name('lean-spec')\n  .description('Manage LeanSpec documents')\n  .version(packageJson.version);\n\n// Add custom help text with grouped commands\nprogram.addHelpText('after', `\nCommand Groups:\n\n  Core Workflow:\n    archive <spec>                Move spec to archived/\n    backfill [specs...]           Backfill timestamps from git history\n    create <name>                 Create new spec\n    examples                      List example projects for tutorials\n    init                          Initialize LeanSpec in current directory\n    link <spec>                   Add relationships between specs\n    migrate <input-path>          Migrate specs from other SDD tools\n    unlink <spec>                 Remove relationships between specs\n    update <spec>                 Update spec metadata\n    \n  Discovery & Search:\n    files <spec>                  List files in a spec\n    list                          List all specs\n    open <spec>                   Open spec in editor\n    search <query>                Full-text search with metadata filters\n    view <spec>                   View spec content\n    \n  Project Analytics:\n    board                         Show Kanban-style board view\n    deps <spec>                   Show dependency graph for a spec\n    gantt                         Show timeline with dependencies\n    stats                         Show aggregate statistics\n    timeline                      Show creation/completion over time\n    \n  Quality & Optimization:\n    analyze <spec>                Analyze spec complexity and structure\n    check                         Check for sequence conflicts\n    tokens [spec]                 Count tokens for LLM context management\n    validate [specs...]           Validate specs for quality issues\n    \n  Advanced Editing:\n    compact <spec>                Remove specified line ranges from spec\n    split <spec>                  Split spec into multiple files\n    \n  Configuration:\n    templates                     Manage spec templates\n    \n  Integration:\n    mcp                           Start MCP server for AI assistants\n    ui                            Start local web UI for spec management\n\nExamples:\n  $ lean-spec init\n  $ lean-spec init -y\n  $ lean-spec init --example dark-theme\n  $ lean-spec init --example dashboard-widgets --name my-demo\n  $ lean-spec examples\n  $ lean-spec create my-feature --priority high\n  $ lean-spec list --status in-progress\n  $ lean-spec view 042\n  $ lean-spec link 085 --depends-on 042,035\n  $ lean-spec link 085 --related 082\n  $ lean-spec unlink 085 --depends-on 042\n  $ lean-spec deps 085\n  $ lean-spec backfill --dry-run\n  $ lean-spec migrate ./docs/adr\n  $ lean-spec migrate ./docs/rfcs --with copilot\n  $ lean-spec board --tag backend\n  $ lean-spec search \"authentication\"\n  $ lean-spec validate\n  $ lean-spec tokens 059\n  $ lean-spec analyze 045 --json\n  $ lean-spec split 045 --output README.md:1-150 --output DESIGN.md:151-end\n  $ lean-spec ui\n  $ lean-spec ui --port 3001 --no-open\n  $ lean-spec ui --specs ./docs/specs --dry-run\n`);\n\n// Register all commands (alphabetically ordered)\nregisterCommands(program);\n\n// Parse and execute\nprogram.parse();\n"]}

package/dist/mcp-server.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-export { createMcpServer } from './chunk-YKBICZNR.js';
+export { createMcpServer } from './chunk-6FKLWECL.js';
 import './chunk-LVD7ZAVZ.js';
 //# sourceMappingURL=mcp-server.js.map
 //# sourceMappingURL=mcp-server.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lean-spec",
-  "version": "0.2.5-dev.20251124050427",
+  "version": "0.2.5-dev.20251124054449",
   "description": "Specification-driven development made simple",
   "type": "module",
   "bin": {

package/templates/examples/dark-theme/README.md

@@ -0,0 +1,55 @@
+# Dark Theme Demo
+
+> **Tutorial**: [Adding Dark Theme Support](https://leanspec.dev/docs/tutorials/adding-dark-theme)
+
+## Scenario
+
+You're building a personal task manager web app. The app works great, but users keep requesting a dark mode option for late-night productivity sessions. Currently, the app only has a bright light theme that can strain eyes in low-light environments.
+
+## What's Here
+
+A minimal single-page task manager with:
+- Task creation and listing interface
+- Simple Express.js server serving static files
+- Clean light theme CSS
+- No dark mode support (yet!)
+
+**Files:**
+- `src/server.js` - Express server for static files
+- `src/public/index.html` - Task manager interface
+- `src/public/style.css` - Current light theme styles
+- `src/public/app.js` - Task management logic
+
+## Getting Started
+
+```bash
+# Install dependencies
+npm install
+
+# Start the server
+npm start
+
+# Open in your browser:
+# http://localhost:3000
+```
+
+## Your Mission
+
+Add dark theme support with automatic switching based on system preferences. Follow the tutorial and ask your AI assistant:
+
+> "Help me add dark theme support to this app using LeanSpec. It should automatically switch based on the user's system theme preference."
+
+The AI will guide you through:
+1. Creating a spec for dark theme support
+2. Designing the CSS for dark mode
+3. Implementing system preference detection
+4. Testing the theme switching
+
+## Current Limitations
+
+- Only light theme available
+- No manual theme toggle
+- Colors may not be fully accessible
+- No theme persistence
+
+These are perfect opportunities to practice spec-driven development!

package/templates/examples/{email-notifications → dark-theme}/package.json

@@ -1,7 +1,7 @@
 {
-  "name": "email-notifications-demo",
+  "name": "dark-theme-demo",
   "version": "1.0.0",
-  "description": "Simple Express.js API for LeanSpec Tutorial 1",
+  "description": "Simple web app for LeanSpec Dark Theme Tutorial",
   "type": "module",
   "scripts": {
     "start": "node src/server.js",

package/templates/examples/dark-theme/src/public/app.js

@@ -0,0 +1,92 @@
+// Task Manager - Simple task tracking
+let tasks = [];
+let taskIdCounter = 1;
+
+const taskInput = document.getElementById('taskInput');
+const addButton = document.getElementById('addButton');
+const taskList = document.getElementById('taskList');
+const taskCount = document.getElementById('taskCount');
+
+// Add task on button click
+addButton.addEventListener('click', addTask);
+
+// Add task on Enter key
+taskInput.addEventListener('keypress', (e) => {
+  if (e.key === 'Enter') {
+    addTask();
+  }
+});
+
+function addTask() {
+  const text = taskInput.value.trim();
+  
+  if (!text) {
+    return;
+  }
+
+  const task = {
+    id: taskIdCounter++,
+    text: text,
+    completed: false
+  };
+
+  tasks.push(task);
+  taskInput.value = '';
+  
+  renderTasks();
+}
+
+function toggleTask(id) {
+  const task = tasks.find(t => t.id === id);
+  if (task) {
+    task.completed = !task.completed;
+    renderTasks();
+  }
+}
+
+function deleteTask(id) {
+  tasks = tasks.filter(t => t.id !== id);
+  renderTasks();
+}
+
+function renderTasks() {
+  // Clear list
+  taskList.innerHTML = '';
+
+  // Show empty state if no tasks
+  if (tasks.length === 0) {
+    taskList.innerHTML = '<div class="empty-state">No tasks yet. Add one above to get started!</div>';
+    taskCount.textContent = '0 tasks';
+    return;
+  }
+
+  // Render each task
+  tasks.forEach(task => {
+    const li = document.createElement('li');
+    li.className = `task-item ${task.completed ? 'completed' : ''}`;
+    
+    li.innerHTML = `
+      <div class="task-content">
+        <input type="checkbox" class="task-checkbox" ${task.completed ? 'checked' : ''} 
+               onchange="toggleTask(${task.id})">
+        <span class="task-text">${escapeHtml(task.text)}</span>
+      </div>
+      <button class="delete-button" onclick="deleteTask(${task.id})">Delete</button>
+    `;
+    
+    taskList.appendChild(li);
+  });
+
+  // Update count
+  const remaining = tasks.filter(t => !t.completed).length;
+  taskCount.textContent = `${remaining} task${remaining !== 1 ? 's' : ''} remaining`;
+}
+
+function escapeHtml(text) {
+  const div = document.createElement('div');
+  div.textContent = text;
+  return div.innerHTML;
+}
+
+// Initial render
+renderTasks();

package/templates/examples/dark-theme/src/public/index.html

@@ -0,0 +1,38 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Task Manager</title>
+  <link rel="stylesheet" href="style.css">
+</head>
+<body>
+  <div class="container">
+    <header>
+      <h1>My Tasks</h1>
+      <p class="subtitle">Stay organized, stay productive</p>
+    </header>
+
+    <main>
+      <div class="task-input">
+        <input type="text" id="taskInput" placeholder="What needs to be done?" />
+        <button id="addButton">Add Task</button>
+      </div>
+
+      <div class="task-list">
+        <ul id="taskList"></ul>
+      </div>
+
+      <div class="stats">
+        <span id="taskCount">0 tasks</span>
+      </div>
+    </main>
+
+    <footer>
+      <p>Built with ❤️ • Try adding dark theme support!</p>
+    </footer>
+  </div>
+
+  <script src="app.js"></script>
+</body>
+</html>

package/templates/examples/dark-theme/src/public/style.css

@@ -0,0 +1,163 @@
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+
+body {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+  background-color: #f5f5f5;
+  color: #333;
+  line-height: 1.6;
+  padding: 20px;
+}
+
+.container {
+  max-width: 600px;
+  margin: 0 auto;
+  background: white;
+  border-radius: 12px;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+  padding: 30px;
+}
+
+header {
+  text-align: center;
+  margin-bottom: 30px;
+  padding-bottom: 20px;
+  border-bottom: 2px solid #e0e0e0;
+}
+
+h1 {
+  font-size: 2em;
+  color: #2c3e50;
+  margin-bottom: 8px;
+}
+
+.subtitle {
+  color: #7f8c8d;
+  font-size: 0.95em;
+}
+
+.task-input {
+  display: flex;
+  gap: 10px;
+  margin-bottom: 25px;
+}
+
+#taskInput {
+  flex: 1;
+  padding: 12px 16px;
+  border: 2px solid #e0e0e0;
+  border-radius: 8px;
+  font-size: 1em;
+  transition: border-color 0.2s;
+}
+
+#taskInput:focus {
+  outline: none;
+  border-color: #3498db;
+}
+
+#addButton {
+  padding: 12px 24px;
+  background: #3498db;
+  color: white;
+  border: none;
+  border-radius: 8px;
+  font-size: 1em;
+  cursor: pointer;
+  transition: background 0.2s;
+}
+
+#addButton:hover {
+  background: #2980b9;
+}
+
+.task-list {
+  min-height: 200px;
+}
+
+#taskList {
+  list-style: none;
+}
+
+.task-item {
+  padding: 15px;
+  margin-bottom: 10px;
+  background: #f8f9fa;
+  border-radius: 8px;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  transition: background 0.2s;
+}
+
+.task-item:hover {
+  background: #e9ecef;
+}
+
+.task-item.completed {
+  opacity: 0.6;
+}
+
+.task-item.completed .task-text {
+  text-decoration: line-through;
+}
+
+.task-content {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex: 1;
+}
+
+.task-checkbox {
+  width: 20px;
+  height: 20px;
+  cursor: pointer;
+}
+
+.task-text {
+  font-size: 1em;
+  color: #2c3e50;
+}
+
+.delete-button {
+  padding: 6px 12px;
+  background: #e74c3c;
+  color: white;
+  border: none;
+  border-radius: 6px;
+  font-size: 0.85em;
+  cursor: pointer;
+  transition: background 0.2s;
+}
+
+.delete-button:hover {
+  background: #c0392b;
+}
+
+.stats {
+  margin-top: 20px;
+  padding-top: 20px;
+  border-top: 2px solid #e0e0e0;
+  text-align: center;
+  color: #7f8c8d;
+  font-size: 0.9em;
+}
+
+footer {
+  margin-top: 30px;
+  padding-top: 20px;
+  border-top: 2px solid #e0e0e0;
+  text-align: center;
+  color: #95a5a6;
+  font-size: 0.85em;
+}
+
+.empty-state {
+  text-align: center;
+  padding: 40px 20px;
+  color: #95a5a6;
+}

package/templates/examples/dark-theme/src/server.js

@@ -0,0 +1,17 @@
+import express from 'express';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const app = express();
+const PORT = 3000;
+
+// Serve static files from public directory
+app.use(express.static(path.join(__dirname, 'public')));
+
+app.listen(PORT, () => {
+  console.log(`✓ Task Manager running at http://localhost:${PORT}`);
+  console.log(`✓ Open your browser and try adding some tasks!`);
+});