uniweb 0.12.39 → 0.12.41

package/README.md

@@ -347,10 +347,11 @@ Markdown in a git repo and content in the Uniweb apps can share the same site. D
 | Command | What it does |
 | --- | --- |
 | `uniweb add ci --host=<adapter>` | Scaffold a CI workflow in your repo (today: `github-pages`). The host runs `uniweb build` on each push. |
-| `uniweb deploy` | Deploy to Uniweb hosting (default). With `--host=<adapter>`, push directly to a static host — builds, uploads, invalidates in one step. |
+| `uniweb publish` | Go live on Uniweb hosting (paid) — syncs content, brings the site's foundation along, and serves dynamically. The canonical verb for Uniweb hosting. |
+| `uniweb deploy --host=<adapter>` | Ship to a third-party static host in one step — builds `dist/`, uploads, invalidates. |
 | `uniweb export` | Produce a self-contained `dist/` for any static host. You upload it yourself. `--host=<adapter>` adds host-specific helper files. |
 | `uniweb register --scope @org` | Register a foundation to the registry (path 2). |
-| `uniweb build` | Inspect a build locally. For shipping, use `deploy` or `export`. |
+| `uniweb build` | Inspect a build locally. For shipping, use `publish` (Uniweb hosting) or `deploy`/`export` (static hosts). |
 | `uniweb update` | Align this project with the CLI you're running: bump `@uniweb/*` deps in every `package.json` to the CLI's matrix (then install), and refresh `AGENTS.md`. Pins to *this* CLI's matrix — run `npx uniweb@latest update` to align to the latest release. Updating the CLI itself is your package manager's job (`npm i -g uniweb@latest`). |
 
 `--host=<adapter>` is the same option across `deploy`, `export`, and `add ci`. Built-in adapters: `cloudflare-pages`, `netlify`, `github-pages`, `vercel`, `s3-cloudfront`, `generic-static`. Each adapter implements only the operations it supports — `add ci` is currently `github-pages`-only because it's the only one that needs a workflow file in the repo.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.12.39",
+  "version": "0.12.41",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -41,12 +41,12 @@
     "js-yaml": "^4.1.0",
     "prompts": "^2.4.2",
     "tar": "^7.0.0",
-    "@uniweb/core": "0.7.15",
-    "@uniweb/kit": "0.9.19",
-    "@uniweb/runtime": "0.8.21"
+    "@uniweb/core": "0.7.16",
+    "@uniweb/kit": "0.9.20",
+    "@uniweb/runtime": "0.8.22"
   },
   "peerDependencies": {
-    "@uniweb/build": "0.14.22",
+    "@uniweb/build": "0.14.24",
     "@uniweb/content-reader": "1.1.12",
     "@uniweb/semantic-parser": "1.1.17"
   },

package/src/commands/add.js

@@ -31,7 +31,7 @@ import { detectPackageManager, filterCmd, installCmd } from '../utils/pm.js'
 import { isNonInteractive, getCliPrefix, stripNonInteractiveFlag, formatOptions } from '../utils/interactive.js'
 import { resolveTemplate } from '../templates/index.js'
 import { validateTemplate } from '../templates/validator.js'
-import { getVersionsForTemplates } from '../versions.js'
+import { getVersionsForTemplates, PNPM_VERSION } from '../versions.js'
 
 // Colors for terminal output
 const colors = {
@@ -952,7 +952,7 @@ export default function ${name}({ content, params }) {
  * Add a CI deploy workflow for a host adapter.
  *
  * Wires through the host-adapter registry: each adapter optionally
- * exports `initCi({ rootDir, site, packageManager, nodeVersion })`
+ * exports `initCi({ rootDir, site, packageManager, nodeVersion, pnpmVersion })`
  * returning `{ files, postInstructions }`. The CLI handles file writes,
  * --force overwrite, and consistent output. Today only github-pages
  * implements initCi; the registry's other adapters (cloudflare-pages,
@@ -1069,6 +1069,7 @@ async function addCi(rootDir, opts, pm = 'pnpm') {
     site,
     packageManager: pm,
     nodeVersion,
+    pnpmVersion: PNPM_VERSION,
     domain: resolvedDomain,
   })
 

package/src/framework-index.json

@@ -1,9 +1,9 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-07-06T06:37:42.354Z",
+  "generatedAt": "2026-07-13T21:48:20.211Z",
   "packages": {
     "@uniweb/build": {
-      "version": "0.14.22",
+      "version": "0.14.24",
       "path": "framework/build",
       "deps": [
         "@uniweb/content-reader",
@@ -25,7 +25,7 @@
       "deps": []
     },
     "@uniweb/core": {
-      "version": "0.7.15",
+      "version": "0.7.16",
       "path": "framework/core",
       "deps": [
         "@uniweb/semantic-parser",
@@ -43,7 +43,7 @@
       "deps": []
     },
     "@uniweb/kit": {
-      "version": "0.9.19",
+      "version": "0.9.20",
       "path": "framework/kit",
       "deps": [
         "@uniweb/core",
@@ -61,7 +61,7 @@
       "deps": []
     },
     "@uniweb/runtime": {
-      "version": "0.8.21",
+      "version": "0.8.22",
       "path": "framework/runtime",
       "deps": [
         "@uniweb/core",
@@ -89,17 +89,17 @@
       "deps": []
     },
     "@uniweb/templates": {
-      "version": "0.7.41",
+      "version": "0.7.42",
       "path": "framework/templates",
       "deps": []
     },
     "@uniweb/theming": {
-      "version": "0.1.4",
+      "version": "0.1.5",
       "path": "framework/theming",
       "deps": []
     },
     "@uniweb/unipress": {
-      "version": "0.4.29",
+      "version": "0.4.31",
       "path": "framework/unipress",
       "deps": [
         "@uniweb/build",

package/src/index.js

@@ -44,7 +44,7 @@ import {
 } from './templates/index.js'
 import { validateTemplate } from './templates/validator.js'
 import { scaffoldWorkspace, scaffoldFoundation, scaffoldSite, applyContent, applyStarter, mergeTemplateDependencies, getWorkspaceTemplateOutputs } from './utils/scaffold.js'
-import { detectPackageManager, filterCmd, installCmd, runCmd } from './utils/pm.js'
+import { detectPackageManager, filterCmd, installCmd, runCmd, isPnpmAvailable } from './utils/pm.js'
 import { isNonInteractive, getCliPrefix, stripNonInteractiveFlag, formatOptions } from './utils/interactive.js'
 import { findWorkspaceRoot } from './utils/workspace.js'
 
@@ -1054,23 +1054,28 @@ async function main() {
   // Success message
   title('Project created successfully!')
 
+  // Recommend pnpm (the framework's package manager) when it's installed,
+  // otherwise fall back to however the user invoked the CLI. The scaffold
+  // supports both — the root package.json declares npm `workspaces` and a
+  // pnpm-workspace.yaml ships next to it.
+  const recPm = isPnpmAvailable() ? 'pnpm' : pm
+
   if (isBlank) {
     log(`Next steps:\n`)
     if (!inPlace) log(`  ${colors.cyan}cd ${projectName}${colors.reset}`)
     log(`  ${colors.cyan}${prefix} add project${colors.reset}`)
-    log(`  ${colors.cyan}${installCmd(pm)}${colors.reset}`)
-    log(`  ${colors.cyan}${prefix} dev${colors.reset}                       ${colors.dim}# Start dev server${colors.reset}`)
+    log(`  ${colors.cyan}${installCmd(recPm)}${colors.reset}`)
+    log(`  ${colors.cyan}${runCmd(recPm, 'dev')}${colors.reset}   ${colors.dim}# start the dev server${colors.reset}`)
   } else {
     log(`Next steps:\n`)
     if (!inPlace) log(`  ${colors.cyan}cd ${projectName}${colors.reset}`)
-    log(`  ${colors.cyan}${installCmd(pm)}${colors.reset}`)
-    log(`  ${colors.cyan}${prefix} dev${colors.reset}                       ${colors.dim}# Start dev server${colors.reset}`)
+    log(`  ${colors.cyan}${installCmd(recPm)}${colors.reset}`)
+    log(`  ${colors.cyan}${runCmd(recPm, 'dev')}${colors.reset}   ${colors.dim}# start the dev server${colors.reset}`)
+  }
+  if (recPm !== 'pnpm') {
+    log('')
+    log(`  ${colors.dim}Tip: pnpm is recommended (https://pnpm.io) — npm works too.${colors.reset}`)
   }
-  log('')
-  log(`When ready to ship:\n`)
-  log(`  ${colors.cyan}${prefix} deploy${colors.reset}                     ${colors.dim}# Uniweb hosting (default; uniweb login first)${colors.reset}`)
-  log(`  ${colors.cyan}${prefix} deploy --host=<adapter>${colors.reset}    ${colors.dim}# cloudflare-pages, netlify, vercel, github-pages, s3-cloudfront${colors.reset}`)
-  log(`  ${colors.cyan}${prefix} export${colors.reset}                     ${colors.dim}# Build dist/ for any static host (no Uniweb account)${colors.reset}`)
   log('')
   log(`  ${colors.dim}See ${colors.reset}${colors.cyan}${prefix} <command> --help${colors.reset}${colors.dim} for command-specific options.${colors.reset}`)
   log('')

package/src/utils/pm.js

@@ -7,6 +7,7 @@
 
 import { existsSync } from 'node:fs'
 import { join } from 'node:path'
+import { execSync } from 'node:child_process'
 
 /**
  * Detect which package manager invoked the CLI.
@@ -84,6 +85,22 @@ export function filterCmd(pm, pkg, cmd) {
     : `npm -w ${pkg} run ${cmd}`
 }
 
+/**
+ * Whether pnpm is available on the current PATH. Used to recommend pnpm
+ * (the framework's package manager) in post-scaffold next steps while still
+ * falling back gracefully when it isn't installed. Mirrors the `git --version`
+ * probe the create flow already uses to feature-detect git.
+ * @returns {boolean}
+ */
+export function isPnpmAvailable() {
+  try {
+    execSync('pnpm --version', { stdio: 'ignore' })
+    return true
+  } catch {
+    return false
+  }
+}
+
 /**
  * Generate an install command.
  * @param {'pnpm' | 'yarn' | 'npm'} pm

package/src/versions.js

@@ -52,6 +52,18 @@ let resolvedVersions = null
  */
 export const REACT_VERSION = '^19.0.0'
 
+/**
+ * The pnpm major the framework's generated CI standardizes on.
+ *
+ * Scaffolded CI workflows (`uniweb add ci --host=github-pages`) pin pnpm
+ * through `pnpm/action-setup`. This is the one place that value lives, so the
+ * pin tracks a single supported major instead of drifting as a hardcoded
+ * literal inside each host adapter. A bare major installs the latest patch of
+ * that major at CI run time. Bump this when the framework moves to a new pnpm
+ * major (latest stable is 11.x as of this writing; pnpm 12 is still alpha).
+ */
+export const PNPM_VERSION = '11'
+
 /**
  * Get the CLI's own package.json
  */