uniweb 1.21.19 → 1.21.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "1.21.19",
+  "version": "1.21.20",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -41,15 +41,15 @@
     "js-yaml": "^4.3.2",
     "prompts": "^2.4.2",
     "tar": "^7.5.21",
-    "@uniweb/schemas": "~1.6.5",
+    "@uniweb/content-writer": "~1.3.1",
     "@uniweb/core": "~1.4.12",
-    "@uniweb/semantic-parser": "~1.13.0",
-    "@uniweb/content-writer": "~1.3.1"
+    "@uniweb/schemas": "~1.6.5",
+    "@uniweb/semantic-parser": "~1.13.0"
   },
   "peerDependencies": {
-    "@uniweb/semantic-parser": "~1.13.0",
+    "@uniweb/build": "~1.10.13",
     "@uniweb/content-reader": "~1.5.7",
-    "@uniweb/build": "~1.10.12"
+    "@uniweb/semantic-parser": "~1.13.0"
   },
   "peerDependenciesMeta": {
     "@uniweb/build": {

package/partials/agents.md

@@ -733,6 +733,8 @@ end the list with `...`.**
 
 **The tab icon:** `favicon: /favicon.svg` in `site.yml`, a file in `public/`. Name it even when the file is `public/favicon.svg`: a static build finds `public/favicon.{svg,ico,png}` on its own, but a site published with `uniweb publish` links only the favicon `site.yml` names (`uniweb doctor --fix favicon-unnamed` writes the line).
 
+**The home-screen icon:** `touchIcon: /touch-icon.png` in `site.yml` — the icon iOS puts on a home screen, which an SVG favicon never is. Make it a 180×180 PNG in `public/` with no transparency: iOS draws a transparent pixel black. Name it even when the file is `public/apple-touch-icon.png`, which iOS finds on a static host by itself: a site published with `uniweb publish` has only the touch icon `site.yml` names. `uniweb doctor` checks the file.
+
 ```yaml
 # site.yml
 keywords: [components, react, cms]

package/src/commands/doctor.js

@@ -1307,6 +1307,92 @@ export async function checkFavicon({ sitePath, siteName, siteYml, issues, should
   log(`    Add ${colors.green}favicon: ${value}${colors.reset} to site.yml — ${colors.dim}uniweb doctor --fix ${id}${colors.reset}`)
 }
 
+// The icon iOS puts on a home screen, from Apple's guidance (the archived Safari Web Content Guide,
+// read 2026-10-27): a PNG — an SVG favicon is not used — 180×180 for the largest iPhone screens,
+// with no transparency, which iOS draws black. A page that links none, iOS asks the site's root for
+// `/apple-touch-icon.png`.
+const TOUCH_ICON_SIZE = 180
+const TOUCH_ICON_FILE = 'apple-touch-icon.png'
+
+/**
+ * The touch icon: `site.yml`'s `touchIcon:`. A static build links the one it names, and a push
+ * sends that file and no other, so a Uniweb host has none the site does not name — not even the
+ * `/apple-touch-icon.png` iOS asks a static host for. A named one is measured: a PNG, square, at
+ * least 180×180, every pixel opaque.
+ */
+export async function checkTouchIcon({ sitePath, siteName, siteYml, issues, shouldFix, fixed: reportFixed }) {
+  const named = typeof siteYml?.touchIcon === 'string' ? siteYml.touchIcon.trim() : ''
+  if (!named) {
+    if (!existsSync(join(sitePath, 'public', TOUCH_ICON_FILE))) {
+      const id = 'touch-icon-none'
+      issues.push({ id, type: 'info', site: siteName, message: 'site.yml names no touch icon, the icon iOS puts on a home screen' })
+      info(`[${id}] site.yml names no touch icon — the icon iOS puts on a home screen and Safari shows on its start page`)
+      log(`    Add a ${TOUCH_ICON_SIZE}×${TOUCH_ICON_SIZE} PNG with no transparency to public/ and name it: ${colors.green}touchIcon: /touch-icon.png${colors.reset}`)
+      return
+    }
+    const id = 'touch-icon-unnamed'
+    const value = `/${TOUCH_ICON_FILE}`
+    const issue = {
+      id,
+      type: 'info',
+      site: siteName,
+      message: `public/${TOUCH_ICON_FILE} is not named in site.yml, so a Uniweb host has no touch icon`,
+      fixable: true
+    }
+    issues.push(issue)
+    info(`[${id}] public/${TOUCH_ICON_FILE} is not named in site.yml — iOS finds it on a static host, but a Uniweb host is never sent it`)
+    if (shouldFix?.(id)) {
+      try {
+        writeSiteConfig(sitePath, { touchIcon: value })
+        issue.fixed = true
+        reportFixed?.(`site.yml now names touchIcon: ${value}`)
+        return
+      } catch (err) {
+        warn(`[${id}] could not write site.yml: ${err.message}`)
+      }
+    }
+    log(`    Add ${colors.green}touchIcon: ${value}${colors.reset} to site.yml — ${colors.dim}uniweb doctor --fix ${id}${colors.reset}`)
+    return
+  }
+
+  if (!isSitePath(named)) return
+  const file = siteFile(sitePath, named)
+  if (!file) {
+    const id = 'touch-icon-missing'
+    issues.push({ id, type: 'warn', site: siteName, message: `touchIcon: ${named} is not in public/ or assets/` })
+    warn(`[${id}] touchIcon: ${named} is not in public/ or assets/ — every page links an icon that is not there`)
+    return
+  }
+  const { readImageSize, isImageOpaque } = await import('@uniweb/build/images')
+  const size = await readImageSize(file)
+  if (!size || size.format !== 'png') {
+    const id = 'touch-icon-format'
+    const what = !size ? 'could not be read as an image' : `is ${size.format.toUpperCase()}, not a PNG`
+    issues.push({ id, type: 'warn', site: siteName, message: `touchIcon: ${named} ${what}` })
+    warn(`[${id}] touchIcon: ${named} ${what} — iOS takes a PNG`)
+    return
+  }
+  if ((await isImageOpaque(file)) === false) {
+    const id = 'touch-icon-transparent'
+    issues.push({ id, type: 'warn', site: siteName, message: `touchIcon: ${named} has transparent pixels, which iOS draws black` })
+    warn(`[${id}] touchIcon: ${named} has transparent pixels — iOS draws them black`)
+    log(`    Give the icon a background of its own.`)
+  }
+  const { width, height } = size
+  const advice =
+    width !== height
+      ? 'not square, as a touch icon is'
+      : width < TOUCH_ICON_SIZE
+        ? `under ${TOUCH_ICON_SIZE}×${TOUCH_ICON_SIZE}, iPhone screens draw it soft`
+        : null
+  if (advice) {
+    const id = 'touch-icon-shape'
+    issues.push({ id, type: 'info', site: siteName, message: `touchIcon: ${named} is ${width}×${height}: ${advice}` })
+    info(`[${id}] touchIcon: ${named} is ${width}×${height}: ${advice}`)
+    log(`    A ${TOUCH_ICON_SIZE}×${TOUCH_ICON_SIZE} PNG is the size iOS asks for.`)
+  }
+}
+
 /** The bare map in `queries.yml`, or `{}` when there is none. */
 function readQueriesYml(sitePath) {
   try {
@@ -1836,9 +1922,10 @@ async function runDoctor(args = []) {
     }
 
     await checkSiteAddress({ sitePath, siteName, siteYml, workspaceDir, issues })
-    // What a link to the site shows, and its tab icon.
+    // What a link to the site shows, its tab icon, and its home-screen icon.
     await checkLinkPreviews({ sitePath, siteName, issues })
     await checkFavicon({ sitePath, siteName, siteYml, issues, shouldFix, fixed })
+    await checkTouchIcon({ sitePath, siteName, siteYml, issues, shouldFix, fixed })
 
     // Forms need a destination, and having none is only visible on the page.
     await checkFormSubmitTarget({ sitePath, siteName, siteYml, issues })

package/src/framework-index.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-10-28T03:03:01.883Z",
+  "generatedAt": "2026-10-28T04:08:25.023Z",
   "packages": {
     "@uniweb/api": {
       "version": "1.6.4"
     },
     "@uniweb/build": {
-      "version": "1.10.12"
+      "version": "1.10.13"
     },
     "@uniweb/content-reader": {
       "version": "1.5.7"