create-pracht 0.6.0 → 0.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pracht",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Interactive and scriptable starter CLI for creating full-stack Preact apps with Pracht.",
   "keywords": [
     "pracht",

package/skills/audit-bundles/SKILL.md

@@ -137,6 +137,14 @@ overrides the route-level strategy for a single anchor (and accepts the extra
 option), so a route can stay on `"intent"` while its primary-nav link opts
 into `"viewport"` or `"render"`.
 
+If every route ends up on `"none"`, do not stop there — the prefetch listeners
+still ship, in a chunk the router lazily imports on every page. Recommend
+`pracht({ client: { prefetch: false } })` instead, which compiles the whole
+mechanism out (~2.6 KB gzip and one fewer request). Confirm nothing relies on
+prefetching first: the router silently stops honouring `route({ prefetch })` and
+`<Link prefetch>`, and the imperative `prefetch()` export becomes a no-op. See
+`docs/PERFORMANCE.md#switching-off-js-prefetching`.
+
 ## Step 7: Report
 
 Three sections:

package/skills/migrate-nextjs/SKILL.md

@@ -424,6 +424,15 @@ the `@pracht/image/client` types once in a `.d.ts`, and keep
 `width`/`height`/`blurDataURL` exactly like Next's static imports. Pracht's
 blur is CSS-only (no fade animation, no inline event handlers).
 
+For apps that relied on `next/image` producing files during a static export,
+use `?pracht&pracht-static` instead. It emits cached responsive WebP variants
+and bypasses the runtime loader while retaining plain, hydration-free `<img>`
+markup. When Markdown content contains relative images, prefer
+`defineMarkdownCollection()` from `@pracht/markdown`; it applies the same
+static pipeline to normal `![alt](./photo.jpg)` syntax. Keep root-relative
+`public/` and remote image URLs unchanged, and use an absolute Vite `base` for
+static variants.
+
 #### `useRouter` → navigation
 
 ```tsx

package/skills/pracht-debug/SKILL.md

@@ -72,6 +72,14 @@ Work through these in order, stopping when you find the root cause:
   - Date/time rendering differences
   - Browser-only APIs used during SSR (`window`, `document`, `localStorage`)
   - Conditional rendering based on client state
+  - Two copies of `@pracht/core` in the SSR module graph. The tell is that
+    `useLocation()` returns `/`, `useParams()` returns `{}`, and
+    `useRouteData()` returns `undefined` in the server-rendered HTML for
+    *every* page, while the hydrated client is correct — the provider and the
+    hooks hold different `createContext()` objects. The plugin prevents this by
+    keeping `@pracht/*` in `ssr.noExternal` (dev and build alike); listing a
+    `@pracht/*` package in `ssr.external` overrides that and brings the split
+    back.
 - **Missing shell**: Referencing an unregistered shell name throws at manifest resolution — `Unknown shell "..." for route "...". Did you mean "..."? Registered shells: ...` — and shows up in the dev error overlay as soon as the server loads the manifest. Verify the shell is registered in `defineApp({ shells: { ... } })` and assigned to the route/group.
 - **404 page**: Route not matched — check manifest wiring (step 1). In `pracht dev`, unmatched navigations render a dev-only 404 page listing every registered route with its render mode; compare the requested path against that table. The route table is also printed on dev-server startup and available via `pracht inspect routes`. Apps that declare `defineApp({ notFound })` render their own 404 page instead (in dev and production alike), so the route table is not shown — check `pracht inspect routes` directly. A 404 on a URL you *do* expect to work usually means the loader threw `notFound()`, not that matching failed.
 

package/skills/pracht-deploy/SKILL.md

@@ -133,7 +133,7 @@ pracht build
 npx wrangler deploy
 ```
 
-To smoke-test the built worker locally first, run `pracht preview` — it builds and then delegates to `wrangler dev`, which serves the wrangler config's `main` entry, `dist/server/worker.js`.
+To smoke-test the built worker locally first, run `pracht preview` — it builds and then delegates to `wrangler dev`, which serves the wrangler config's `main` entry, `dist/server/worker.js`. Keep `no_bundle: true` and the JavaScript `ESModule` rule: Pracht's Vite output is already bundled and can contain lazy server chunks that Wrangler must upload separately.
 
 Wrangler owns the Worker's binding environment. Put local-only secrets such as
 `PRACHT_CONFIRMATION_SECRET` and `PRACHT_REVALIDATE_TOKEN` in a gitignored
@@ -151,8 +151,10 @@ pracht build
 npx wrangler dev --config wrangler.local.jsonc --port 3000
 ```
 
-The local config must keep `main: "dist/server/worker.js"` and omit the
-production route. `pracht preview` does not forward Wrangler's `--config` flag.
+The local config must keep `main: "dist/server/worker.js"`, keep
+`no_bundle: true`, include the JavaScript `ESModule` rule, and omit the
+production route. `pracht preview` does not forward Wrangler's `--config`
+flag.
 
 ### Wrangler Configuration
 
@@ -161,6 +163,8 @@ production route. `pracht preview` does not forward Wrangler's `--config` flag.
 {
   "name": "my-pracht-app",
   "main": "dist/server/worker.js",
+  "no_bundle": true,
+  "rules": [{ "type": "ESModule", "globs": ["**/*.js", "**/*.mjs"] }],
   "compatibility_date": "2026-04-06",
   "assets": {
     "binding": "ASSETS",
@@ -170,7 +174,7 @@ production route. `pracht preview` does not forward Wrangler's `--config` flag.
 }
 ```
 
-`"binding": "ASSETS"` and `"run_worker_first": true` are required. Without the binding, the worker's `env.ASSETS` resolves to nothing and the runtime silently falls back to `null` — headers and ISG manifests load empty, so SSG serving, ISG revalidation, and per-route headers all silently no-op. The canonical config lives at `examples/cloudflare/wrangler.jsonc`. If you rename the binding with `assetsBinding` (below), the wrangler `binding` value must match.
+`"no_bundle": true`, the JavaScript `ESModule` rule, `"binding": "ASSETS"`, and `"run_worker_first": true` are required. Without the first two settings, Wrangler either re-bundles Pracht's Vite output and folds lazy server chunks into the entry or omits those chunks from the upload. Without the binding, the worker's `env.ASSETS` resolves to nothing and the runtime silently falls back to `null` — headers and ISG manifests load empty, so SSG serving, ISG revalidation, and per-route headers all silently no-op. The canonical config lives at `examples/cloudflare/wrangler.jsonc`. If you rename the binding with `assetsBinding` (below), the wrangler `binding` value must match.
 
 ### Bindings (KV, D1, R2)
 

package/skills/pre-deploy/SKILL.md

@@ -98,6 +98,10 @@ a markdown summary (graph diff + verify + budgets) worth attaching to it.
   validates every named export of the deploy entry and rejects the build
   metadata (`buildTarget`, manifests, `resolvedApp`, ...) that `server.js`
   exports for the prerender pass.
+- `no_bundle` is `true`, with an `ESModule` rule whose globs include
+  `"**/*.js"`. Pracht's Vite output is already bundled and may contain lazy
+  server chunks; these settings make Wrangler upload the chunks as separate
+  modules instead of folding them into the entry file.
 - `assets.directory` points to `dist/client`.
 - `compatibility_date` is set, and is a date the installed workerd supports.
   It must not be *newer* than the runtime: workerd refuses to start with
@@ -128,8 +132,10 @@ a markdown summary (graph diff + verify + budgets) worth attaching to it.
   gateway with a normalized `cf.cacheKey`; also check that markdown-capable
   routes normalize `Accept` at the gateway when variant fan-out matters.
 - Bundle size: measure what actually deploys — `dist/server/worker.js` plus
-  its `dist/server/server.js` import (wrangler bundles the import graph of
-  `main`; `worker.js` alone is a few lines). Workers limit is ~1 MB
+  its `dist/server/server.js` import and lazy chunks (`no_bundle: true` plus
+  the JavaScript `ESModule` rule uploads the pre-built module graph;
+  `worker.js` alone is a few lines).
+  Workers limit is ~1 MB
   compressed for free tier, ~10 MB on paid. Warn at 80% of the active limit.
 
 ### Vercel (`@pracht/adapter-vercel`)

package/skills/typed-routes/SKILL.md

@@ -107,8 +107,12 @@ same-origin anchor. It also accepts navigation-behavior props:
 `prefetch="none" | "hover" | "intent" | "viewport" | "render"` (per-link
 prefetch strategy, default `"intent"`), `preserveScroll` (keep the scroll
 position), and `viewTransition` (animate the navigation with the View Transitions API
-where supported). There is also an imperative `prefetch()` export and a
-`useNavigation()` hook for pending navigation/submission state.
+where supported). Set `speculate={false}` on links that browser speculation
+rules must not prefetch or prerender. Because it is independent of the JS
+`prefetch` strategy, use both `speculate={false}` and `prefetch="none"` for GET
+links with side effects. There is also an imperative
+`prefetch()` export and a `useNavigation()` hook for pending
+navigation/submission state.
 
 ### Outside components
 

package/skills/upgrade-pracht/SKILL.md

@@ -33,8 +33,9 @@ pnpm list --depth 1 --json | grep -A2 '@pracht/'   # or read package.json + lock
 
 The family: `@pracht/core`, `@pracht/cli`, `@pracht/vite-plugin`,
 `@pracht/adapter-node`, `@pracht/adapter-cloudflare`, `@pracht/adapter-vercel`,
-`@pracht/preact-ssr-precompile`, `@pracht/image`. Get the latest published
-versions with `npm view <pkg> version`.
+`@pracht/preact-ssr-precompile`, `@pracht/content`, `@pracht/markdown`,
+`@pracht/image`. Get the latest published versions with
+`npm view <pkg> version`.
 
 ## Step 2: Understand the versioning model
 
@@ -75,6 +76,8 @@ https://raw.githubusercontent.com/JoviDeCroock/pracht/main/packages/<dir>/CHANGE
 | `@pracht/vite-plugin` | `packages/vite-plugin` |
 | `@pracht/adapter-node` / `-cloudflare` / `-vercel` | `packages/adapter-*` |
 | `@pracht/preact-ssr-precompile` | `packages/preact-ssr-precompile` |
+| `@pracht/content` | `packages/content` |
+| `@pracht/markdown` | `packages/markdown` |
 | `@pracht/image` | `packages/image` |
 
 Changelogs are changesets-generated: `## X.Y.Z` sections containing

package/src/index.js

@@ -1298,6 +1298,11 @@ function createWranglerConfig(projectName) {
     // validates every named export of the deployed entry module and rejects the
     // build metadata (buildTarget, manifests, ...) server.js also exports.
     '  "main": "dist/server/worker.js",',
+    // Pracht's Vite build is the authoritative bundle and may contain lazy
+    // server chunks. A second Wrangler bundle would inline them again; the
+    // module rule makes Wrangler upload those chunks next to the entry.
+    '  "no_bundle": true,',
+    '  "rules": [{ "type": "ESModule", "globs": ["**/*.js", "**/*.mjs"] }],',
     `  "compatibility_date": ${JSON.stringify(compatibilityDate)},`,
     '  "assets": {',
     '    "binding": "ASSETS",',