promptslide 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -0,0 +1,57 @@
+# Changelog
+
+## [0.3.2](https://github.com/prompticeu/promptslide/compare/promptslide-v0.3.1...promptslide-v0.3.2) (2026-03-07)
+
+
+### Bug Fixes
+
+* correct package.json path resolution in CLI commands ([#59](https://github.com/prompticeu/promptslide/issues/59)) ([a79e81d](https://github.com/prompticeu/promptslide/commit/a79e81dab73606494cf334121bcbff52273d038c))
+
+## [0.3.1](https://github.com/prompticeu/promptslide/compare/promptslide-v0.3.0...promptslide-v0.3.1) (2026-03-07)
+
+
+### Features
+
+* **cli:** track promptslide version on publish and warn on add ([#58](https://github.com/prompticeu/promptslide/issues/58)) ([503e1f0](https://github.com/prompticeu/promptslide/commit/503e1f0bdac8066fb047b001c4b07c7ff6d87b23))
+
+
+### Bug Fixes
+
+* hoist deckBaseSlug to fix ReferenceError in publish command ([#56](https://github.com/prompticeu/promptslide/issues/56)) ([dd29c36](https://github.com/prompticeu/promptslide/commit/dd29c36ecd862d2e52844933478cb8ef652c0c23))
+* include CHANGELOG.md in published npm packages ([#53](https://github.com/prompticeu/promptslide/issues/53)) ([8a38a55](https://github.com/prompticeu/promptslide/commit/8a38a5533b0ea41593eba901551b0815e9da0515))
+
+## [0.3.0](https://github.com/prompticeu/promptslide/compare/promptslide-v0.2.6...promptslide-v0.3.0) (2026-03-07)
+
+
+### ⚠ BREAKING CHANGES
+
+* move SlideFooter from core to user-land layouts ([#47](https://github.com/prompticeu/promptslide/issues/47))
+
+### Features
+
+* add theme system and reusable slide layouts ([#8](https://github.com/prompticeu/promptslide/issues/8)) ([b107f35](https://github.com/prompticeu/promptslide/commit/b107f35bb9bcc4edf9b171f5947e5e1d0ad8eb2a))
+* **cli:** add --yes flag for non-interactive project scaffolding ([#21](https://github.com/prompticeu/promptslide/issues/21)) ([88d233f](https://github.com/prompticeu/promptslide/commit/88d233fc6f8cc970e4a13f1876cb5a2f06dd13b9))
+* **cli:** add lockfile integrity with file hashing and tracking ([4c6238a](https://github.com/prompticeu/promptslide/commit/4c6238ad6e0cee85e3b918b4a120450262fedb7b))
+* **cli:** add org management, preview image generation, and registry improvements ([a5d36eb](https://github.com/prompticeu/promptslide/commit/a5d36eb8d6dc6098f8bba2746aae711da16461fa))
+* **cli:** add registry commands with lockfile integrity and file hashing ([72ba46e](https://github.com/prompticeu/promptslide/commit/72ba46eff408a28132b6318c0f7b78e7b6b203fe))
+* **cli:** add SlideEmbed and /embed route ([#44](https://github.com/prompticeu/promptslide/issues/44)) ([3014ff8](https://github.com/prompticeu/promptslide/commit/3014ff8fdae6b1bbf8807c00f8c7410a78eff529))
+* merge promptslide-core into promptslide package ([9248ed2](https://github.com/prompticeu/promptslide/commit/9248ed21d4a9d075d9246dd4b2892aa21c41eb0a))
+* move SlideFooter from core to user-land layouts ([#47](https://github.com/prompticeu/promptslide/issues/47)) ([8beae61](https://github.com/prompticeu/promptslide/commit/8beae615f299d3601eedf9faabba38ae7b3ccf81))
+* persist publish slug and add promptslide pull ([#45](https://github.com/prompticeu/promptslide/issues/45)) ([c6b3781](https://github.com/prompticeu/promptslide/commit/c6b37810c272d0ee62223d0362e09d7bb1d37eac))
+* **registry:** add registry cli funcs ([cb3cc2e](https://github.com/prompticeu/promptslide/commit/cb3cc2eca14d9bfe17c24050e066102f83ae093c))
+* show URL after publishing deck or slides ([#46](https://github.com/prompticeu/promptslide/issues/46)) ([25d9791](https://github.com/prompticeu/promptslide/commit/25d97914bb0d666e36756b851cd05fd69fe98a14))
+
+
+### Bug Fixes
+
+* add Windows support for browser open in login command ([3ac57bc](https://github.com/prompticeu/promptslide/commit/3ac57bc375e841a2ef711c1f040f6230b6f2870d))
+* address PR review feedback — arg parsing, import path, and lockfile bugs ([9087a7e](https://github.com/prompticeu/promptslide/commit/9087a7ec001bab05544f401673af0b043d49e90c))
+* build promptslide package and add development exports ([#12](https://github.com/prompticeu/promptslide/issues/12)) ([2e60766](https://github.com/prompticeu/promptslide/commit/2e60766bb41f3a72775bae196d4d7e89bd08897a))
+* CLI security hardening and bug fixes ([52fa1af](https://github.com/prompticeu/promptslide/commit/52fa1af3b4392cdfbd5d673e7a7a9d43ac2db26c))
+* grid view and studio broken by stale file: paths ([#43](https://github.com/prompticeu/promptslide/issues/43)) ([3f5c548](https://github.com/prompticeu/promptslide/commit/3f5c54892e05c5a12e6c7b6f473745e0e7adc8f1))
+* prevent directory argument from being filtered out in create command ([#40](https://github.com/prompticeu/promptslide/issues/40)) ([c1ff8f5](https://github.com/prompticeu/promptslide/commit/c1ff8f5779f0e1687b0064f107ab8d64c753c35f))
+* remove leftover optional chaining on storedFiles in update command ([ed10b3f](https://github.com/prompticeu/promptslide/commit/ed10b3fae1e761deee9b4d046b1af1c93c89cf4a))
+* replace PROJECT_NAME placeholder in theme.ts during scaffolding ([#14](https://github.com/prompticeu/promptslide/issues/14)) ([62f03db](https://github.com/prompticeu/promptslide/commit/62f03db7da286562b574c91f406b800f145edafd))
+* resolve all linting errors in CLI commands ([#50](https://github.com/prompticeu/promptslide/issues/50)) ([8e2a5e8](https://github.com/prompticeu/promptslide/commit/8e2a5e810786cb704e8b42e294bf695ca0e2f9dc))
+* update default registry to promptslide.eu ([#35](https://github.com/prompticeu/promptslide/issues/35)) ([910dd62](https://github.com/prompticeu/promptslide/commit/910dd623c0b17786fe3fc8f15b4b8c94c2be80b6))
+* vertically center content in SlideLayoutCentered layout ([#42](https://github.com/prompticeu/promptslide/issues/42)) ([f53851e](https://github.com/prompticeu/promptslide/commit/f53851ec4cab60b697a186d01f01c8cc6bd7d781))

package/README.md

@@ -0,0 +1,54 @@
+# promptslide
+
+Vibe-code beautiful slide decks using your favorite coding agent.
+
+PromptSlide is a local-first slide framework built with React, Tailwind CSS, and Framer Motion. Open your coding agent (Claude Code, Cursor, Windsurf, etc.), describe the slides you want in natural language, and watch them appear in real-time via Vite's hot module replacement.
+
+## Quick Start
+
+```bash
+bun create slides my-deck
+cd my-deck
+bun install
+bun run dev
+```
+
+Then open your coding agent and say:
+
+> "Create me a 10-slide deck about AgenticRAG"
+
+## CLI Commands
+
+All commands are run via `npx promptslide <command>` (or `bunx promptslide <command>`).
+
+| Command   | Description                              |
+| --------- | ---------------------------------------- |
+| `create`  | Scaffold a new slide deck project        |
+| `studio`  | Start the dev server with hot reload     |
+| `build`   | Build the deck for production            |
+| `preview` | Preview the production build             |
+| `add`     | Add a slide to the current deck          |
+| `remove`  | Remove a slide from the current deck     |
+| `list`    | List all slides in the current deck      |
+| `publish` | Publish the deck to PromptSlide registry |
+| `search`  | Search published decks                   |
+| `pull`    | Pull a published deck                    |
+
+## How It Works
+
+1. **You describe** what you want in natural language
+2. **Your coding agent** uses the [promptslide Skill](https://github.com/prompticeu/promptslide/tree/main/skills/promptslide) to understand the framework
+3. **Agent creates** `.tsx` slide files in `src/slides/`
+4. **Vite hot-reloads** -- slides appear instantly in your browser
+5. **Present** in fullscreen or export to PDF
+
+> The Skill is installed automatically when you run `promptslide create`. To install it manually: `npx skills add prompticeu/promptslide`
+
+## Links
+
+- [GitHub](https://github.com/prompticeu/promptslide)
+- [create-slides](https://www.npmjs.com/package/create-slides) -- scaffolding shortcut
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "promptslide",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "CLI and slide engine for PromptSlide presentations",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,7 +18,9 @@
   "files": [
     "src/",
     "dist/",
-    "templates/"
+    "templates/",
+    "CHANGELOG.md",
+    "README.md"
   ],
   "scripts": {
     "build": "tsup",

package/src/commands/add.mjs

@@ -1,8 +1,9 @@
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs"
 import { execFileSync } from "node:child_process"
-import { join, dirname, resolve, sep } from "node:path"
+import { dirname, join, resolve, sep } from "node:path"
+import { fileURLToPath } from "node:url"
 
-import { bold, green, cyan, red, dim } from "../utils/ansi.mjs"
+import { bold, green, cyan, red, dim, yellow } from "../utils/ansi.mjs"
 import { requireAuth } from "../utils/auth.mjs"
 import {
   fetchRegistryItem,
@@ -22,6 +23,15 @@ import {
 } from "../utils/deck-config.mjs"
 import { confirm, closePrompts } from "../utils/prompts.mjs"
 
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const CLI_VERSION = JSON.parse(readFileSync(join(__dirname, "..", "..", "package.json"), "utf-8")).version
+
+/** Extract minor version number from a version string like "0.3.0" or "^0.3.0". */
+function parseMinor(version) {
+  const match = version.replace(/^[\^~>=<\s]+/, "").match(/^(\d+)\.(\d+)/)
+  return match ? Number(match[2]) : null
+}
+
 export async function add(args) {
   const cwd = process.cwd()
 
@@ -181,6 +191,21 @@ export async function add(args) {
     }
   }
 
+  // Check promptslide version compatibility
+  const publishedVersion = item.promptslideVersion
+  if (publishedVersion) {
+    const publishedMinor = parseMinor(publishedVersion)
+    const localMinor = parseMinor(CLI_VERSION)
+    if (publishedMinor !== null && localMinor !== null && publishedMinor !== localMinor) {
+      console.log()
+      console.log(`  ${yellow("⚠")} This content was published with promptslide ${bold(`v${publishedVersion}`)}`)
+      console.log(`    You have ${bold(`v${CLI_VERSION}`)} installed — this may cause issues.`)
+      const pm = detectPackageManager(cwd)
+      const installCmd = pm === "bun" ? "bun add" : pm === "pnpm" ? "pnpm add" : pm === "yarn" ? "yarn add" : "npm install"
+      console.log(`    Run: ${cyan(`${installCmd} promptslide@^${publishedVersion}`)}`)
+    }
+  }
+
   // Install npm dependencies
   const existingPkg = join(cwd, "package.json")
   if (Object.keys(resolved.npmDeps).length > 0 && existsSync(existingPkg)) {

package/src/commands/create.mjs

@@ -3,7 +3,7 @@ import { existsSync, cpSync, readFileSync, writeFileSync, mkdirSync } from "node
 import { join, resolve, dirname } from "node:path"
 import { fileURLToPath } from "node:url"
 
-import { bold, green, cyan, red, dim } from "../utils/ansi.mjs"
+import { bold, green, cyan, red, dim, yellow } from "../utils/ansi.mjs"
 import { requireAuth } from "../utils/auth.mjs"
 import { hexToOklch, isValidHex } from "../utils/colors.mjs"
 import { prompt, confirm, closePrompts } from "../utils/prompts.mjs"
@@ -169,6 +169,17 @@ export async function create(args) {
     const versionTag = item.version ? ` ${dim(`v${item.version}`)}` : ""
     console.log(`  Using deck ${bold(item.title || item.name)}${versionTag}`)
 
+    // Warn if the deck was published with a different minor version
+    if (item.promptslideVersion) {
+      const pubParts = item.promptslideVersion.match(/^(\d+)\.(\d+)/)
+      const localParts = CLI_VERSION.match(/^(\d+)\.(\d+)/)
+      if (pubParts && localParts && pubParts[2] !== localParts[2]) {
+        console.log()
+        console.log(`  ${yellow("⚠")} This deck was published with promptslide ${bold(`v${item.promptslideVersion}`)}`)
+        console.log(`    You have ${bold(`v${CLI_VERSION}`)} installed — some slides may need updating.`)
+      }
+    }
+
     let resolved
     try {
       resolved = await resolveRegistryDependencies(item, auth, targetDir)

package/src/commands/publish.mjs

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs"
-import { join, basename, relative, extname } from "node:path"
+import { dirname, join, basename, relative, extname } from "node:path"
+import { fileURLToPath } from "node:url"
 
 import { bold, green, cyan, red, dim } from "../utils/ansi.mjs"
 import { requireAuth } from "../utils/auth.mjs"
@@ -8,6 +9,9 @@ import { publishToRegistry, registryItemExists, searchRegistry, updateLockfileIt
 import { prompt, confirm, select, closePrompts } from "../utils/prompts.mjs"
 import { parseDeckConfig } from "../utils/deck-config.mjs"
 
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const CLI_VERSION = JSON.parse(readFileSync(join(__dirname, "..", "..", "package.json"), "utf-8")).version
+
 function readDeckPrefix(cwd) {
   // Prefer stored prefix from lockfile (user's previous choice)
   const lock = readLockfile(cwd)
@@ -292,7 +296,8 @@ async function publishItem({ filePath, cwd, auth, typeOverride, interactive = tr
     npmDependencies: Object.keys(npmDeps).length ? npmDeps : undefined,
     registryDependencies: prefixedDeps.length ? prefixedDeps : undefined,
     releaseNotes: releaseNotes || undefined,
-    previewImage: previewImage || undefined
+    previewImage: previewImage || undefined,
+    promptslideVersion: CLI_VERSION
   }
 
   const result = await publishToRegistry(payload, auth)
@@ -378,6 +383,9 @@ export async function publish(args) {
     const existingSlug = existingLock.deckSlug
     let deckPrefix, deckSlug
 
+    const dirName = basename(cwd)
+    const deckBaseSlug = dirName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "")
+
     if (existingSlug) {
       console.log(`  ${dim("Previously published as")} ${cyan(existingSlug)}`)
       console.log()
@@ -388,14 +396,10 @@ export async function publish(args) {
         deckPrefix = existingSlug.split("/")[0]
       } else {
         deckPrefix = await promptDeckPrefix(cwd, true)
-        const dirName = basename(cwd)
-        const deckBaseSlug = dirName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "")
         deckSlug = `${deckPrefix}/${deckBaseSlug}`
       }
     } else {
       deckPrefix = await promptDeckPrefix(cwd, true)
-      const dirName = basename(cwd)
-      const deckBaseSlug = dirName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "")
       deckSlug = `${deckPrefix}/${deckBaseSlug}`
     }
 
@@ -580,7 +584,8 @@ export async function publish(args) {
             title: "Theme",
             files: themePayloadFiles,
             registryDependencies: assetDeps.length ? assetDeps : undefined,
-            npmDependencies: Object.keys(npmDeps).length ? npmDeps : undefined
+            npmDependencies: Object.keys(npmDeps).length ? npmDeps : undefined,
+            promptslideVersion: CLI_VERSION
           }, auth)
           console.log(`  [${itemIndex}/${totalItems}] ${green("✓")} theme ${cyan(themeSlug)} ${dim(`v${result.version}`)}`)
           updateLockfileItem(cwd, themeSlug, result.version ?? 0, themeFileHashes)
@@ -618,7 +623,8 @@ export async function publish(args) {
           title: titleCase(layoutName),
           files: [{ path: layoutFile, target: "src/layouts/", content }],
           registryDependencies: regDeps.length ? regDeps : undefined,
-          npmDependencies: Object.keys(npmDeps).length ? npmDeps : undefined
+          npmDependencies: Object.keys(npmDeps).length ? npmDeps : undefined,
+          promptslideVersion: CLI_VERSION
         }, auth)
         console.log(`  [${itemIndex}/${totalItems}] ${green("✓")} layout ${cyan(layoutSlug)} ${dim(`v${result.version}`)}`)
         updateLockfileItem(cwd, layoutSlug, result.version ?? 0, fileHashes)
@@ -669,7 +675,8 @@ export async function publish(args) {
           section,
           registryDependencies: regDeps.length ? regDeps : undefined,
           npmDependencies: Object.keys(npmDeps).length ? npmDeps : undefined,
-          previewImage: slidePreview || undefined
+          previewImage: slidePreview || undefined,
+          promptslideVersion: CLI_VERSION
         }, auth)
         console.log(`  [${itemIndex}/${totalItems}] ${green("✓")} slide ${cyan(slideSlug)} ${dim(`v${result.version}`)}`)
         updateLockfileItem(cwd, slideSlug, result.version ?? 0, fileHashes)
@@ -698,7 +705,8 @@ export async function publish(args) {
         files: [],
         registryDependencies: allDeckDeps.length ? allDeckDeps : undefined,
         releaseNotes: releaseNotes || undefined,
-        previewImage: previewImage || undefined
+        previewImage: previewImage || undefined,
+        promptslideVersion: CLI_VERSION
       }, auth)
       console.log(`  [${itemIndex}/${totalItems}] ${green("✓")} deck ${cyan(deckSlug)} ${dim(`v${result.version}`)}`)
       updateLockfileItem(cwd, deckSlug, result.version ?? 0, {})
@@ -886,7 +894,8 @@ export async function publish(args) {
     npmDependencies: Object.keys(npmDeps).length ? npmDeps : undefined,
     registryDependencies: prefixedRegistryDeps.length ? prefixedRegistryDeps : undefined,
     releaseNotes: releaseNotes || undefined,
-    previewImage: previewImage || undefined
+    previewImage: previewImage || undefined,
+    promptslideVersion: CLI_VERSION
   }
 
   try {