getfilepress 0.1.2 → 0.1.3

package/README.md

@@ -34,12 +34,13 @@ The site folder only needs:
 - `filepress.config.ts` — title, URL, and other site settings
 - `posts/` — Markdown posts (`/posts/<slug>`)
 - `pages/` — optional static Markdown pages (`about.md` → `/about`)
+- `paths` mounts — optional site-owned HTML/CSS/JS trees at a URL prefix (e.g. `/docs`)
 - `static/` — favicon, images, etc.
-- `package.json` — depends on this engine (`"getfilepress": "link:../filepress"` locally, `"getfilepress": "^0.1.1"` from npm, or a git URL + tag/SHA)
+- `package.json` — depends on this engine (`"getfilepress": "link:../filepress"` locally, `"getfilepress": "^0.1.3"` from npm, or a git URL + tag/SHA)
 
 ### Import an existing site
 
-Crawl a public site (sitemap/RSS preferred), extract posts and pages, scaffold a sibling FilePress site, and optionally ask a local Ollama model for a token theme:
+Crawl a public site (sitemap/RSS preferred), extract posts and pages, scaffold a sibling FilePress site, and optionally ask Ollama (local or a host found with `--scan`) for a token theme:
 
 ```bash
 pnpm install
@@ -69,7 +70,7 @@ pnpm dev                 # → demo fixture
 pnpm build               # → sites/demo/build/
 pnpm dev:www             # → product site
 pnpm build:www           # → sites/getfilepress/build/
-pnpm deploy:www          # build + Wrangler Pages deploy (project: getfilepress)
+pnpm ship                # build + Wrangler Pages deploy (project: getfilepress)
 ```
 
 ## Site configuration
@@ -101,7 +102,23 @@ export default defineFilepressConfig({
 });
 ```
 
-`title` and `url` are required; missing values fail the build with a clear error. Nav/footer items may set `icon: 'github'` for a built-in mark.
+`title` and `url` are required; missing values fail the build with a clear error.
+
+**Nav / footer:** `nav` is the header; `footerLinks` replaces the default RSS + Topics footer row when set (include those entries yourself if you still want them). Items may set `icon: 'github'` for a built-in mark (`.nav-github` in themes).
+
+### Path mounts
+
+Attach a site-owned HTML/CSS/JS tree at a URL prefix. FilePress copies it into `build/` after the Kit build and serves it in `filepress dev`. It does **not** parse Markdown or inject Essay chrome into the mount — the site owns the shell (e.g. a docs sidebar).
+
+```ts
+paths: [
+  { url: '/docs', dir: 'docs/dist' }
+]
+```
+
+- `dir` is site-relative; `url` starts with `/` and must not collide with engine routes (`posts`, `writing`, `tags`, …).
+- The first URL segment is reserved against `pages/<slug>.md`.
+- HTML files under the mount are included in `sitemap.xml`.
 
 ## Theming
 
@@ -109,8 +126,12 @@ The engine ships a default Essay look. To restyle a site, add `theme.css` next t
 `filepress.config.ts`. It loads after the default theme, so you can override CSS
 variables and structural classes without forking the app.
 
-In local `pnpm dev`, **Genie Mode** lets you steer tokens, stock backgrounds, and
-versioned theme activations without leaving the browser (dev-only; not in production builds).
+In local `filepress dev` / `pnpm dev`, **Genie Mode** (floating FAB) is a design cockpit:
+steers, Openverse / uploads, live inspire URLs, optional Ollama refine, and
+`lede` / `tagline` / `logo` config patches — versioned under `.filepress-genie/`,
+baked into `theme.css` / `static/` / config on activate. Dev-only; absent from
+`preview` and production builds. See [`docs/GENIE_MODE_SPEC.md`](docs/GENIE_MODE_SPEC.md)
+and [getfilepress.com/genie](https://getfilepress.com/genie).
 
 ```css
 /* theme.css */
@@ -161,16 +182,21 @@ Body content in **Markdown**.
 
 ## Deploy
 
-Build output is a static folder. For a site that depends on this engine:
+`filepress build` emits a static `build/` folder — no Node server in production.
+
+**Happy path: [Cloudflare Pages](https://pages.cloudflare.com/)** (git-connected site repo or Wrangler upload).
 
 | Setting | Value |
 | --- | --- |
 | Build command | `pnpm install && pnpm build` |
 | Output directory | `build` |
+| Node | 20+ |
+
+Pin the engine in the site `package.json` (`"getfilepress": "^0.1.1"` or `github:Catalyst-Forge-LLC/filepress#v0.1.1`). Do not use `link:` in CI. Set config `url` to the live origin.
 
-Point the site's dependency at a pinned commit or tag of this repo (not a floating branch) so upgrades are intentional. If this engine repo is private, the host's build needs permission to clone it.
+Any other static host works the same way: publish `build/` as the web root.
 
-More at [getfilepress.com](https://getfilepress.com).
+Full notes (including an agent checklist): [`docs/DEPLOY.md`](docs/DEPLOY.md) · product page: [getfilepress.com/deploy](https://getfilepress.com/deploy).
 
 ## Repository layout
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "getfilepress",
-	"version": "0.1.2",
+	"version": "0.1.3",
 	"private": false,
 	"type": "module",
 	"description": "FilePress — file-based Markdown blog engine. Link this package from a content-only site (config + posts), then run `filepress build`.",
@@ -34,6 +34,7 @@
 	},
 	"files": [
 		"scripts/filepress.mjs",
+		"scripts/copy-path-mounts.mjs",
 		"scripts/create-site.mjs",
 		"scripts/postinstall.mjs",
 		"scripts/link-embedded-packages.mjs",
@@ -47,12 +48,13 @@
 	"scripts": {
 		"postinstall": "node scripts/postinstall.mjs",
 		"filepress": "node scripts/filepress.mjs",
-		"test": "pnpm --filter @filepress/core test && pnpm --filter @filepress/import test",
+		"test": "pnpm --filter @filepress/core test && pnpm --filter @filepress/import test && pnpm --filter @filepress/app test",
 		"check": "pnpm filepress check --site demo",
 		"build": "pnpm filepress build --site demo",
 		"build:demo": "pnpm filepress build --site demo",
 		"build:www": "pnpm filepress build --site getfilepress",
-		"deploy:www": "pnpm build:www && wrangler pages deploy sites/getfilepress/build --project-name getfilepress",
+		"ship": "pnpm build:www && wrangler pages deploy sites/getfilepress/build --project-name getfilepress",
+		"deploy:www": "pnpm ship",
 		"dev": "pnpm filepress dev --site demo",
 		"dev:demo": "pnpm filepress dev --site demo",
 		"dev:www": "pnpm filepress dev --site getfilepress",
@@ -73,6 +75,7 @@
 		"gray-matter": "^4.0.3",
 		"highlight.js": "^11.11.1",
 		"linkedom": "^0.18.12",
+		"ollanet": "^0.4.0",
 		"rehype-autolink-headings": "^7.1.0",
 		"rehype-highlight": "^7.0.2",
 		"rehype-raw": "^7.0.0",

package/packages/app/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@filepress/app",
 	"private": true,
-	"version": "0.1.2",
+	"version": "0.1.3",
 	"type": "module",
 	"description": "The single SvelteKit app for filepress. Sites under sites/* supply config + posts + static; this package owns all routes.",
 	"scripts": {