getfilepress 0.1.2 → 0.1.4

package/README.md

@@ -2,7 +2,7 @@
 
 > File-based Markdown blogs. No admin UI. No database. Just git.
 
-A file-based Markdown blog engine. Posts are plain `.md` files with YAML frontmatter — edit them in the GitHub mobile app, the web editor, or any text editor. There is no admin UI, no database, and no server at runtime: a static build produces HTML you can host anywhere (e.g. Cloudflare Pages).
+A file-based Markdown blog engine. Posts are plain `.md` files with YAML frontmatter. Edit them in the GitHub mobile app, the web editor, or any text editor. There is no admin UI, no database, and no server at runtime: a static build produces HTML you can host anywhere (for example Cloudflare Pages).
 
 | | |
 | --- | --- |
@@ -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 (for example 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. Experiments live under `.filepress-genie/`.
+Activate writes `theme.css`, `static/`, and config. 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.3"` or `github:Catalyst-Forge-LLC/filepress#v0.1.3`). 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,100 +1,100 @@
 {
-	"name": "getfilepress",
-	"version": "0.1.2",
-	"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`.",
-	"license": "MIT",
-	"homepage": "https://getfilepress.com",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/Catalyst-Forge-LLC/filepress.git"
-	},
-	"bugs": {
-		"url": "https://github.com/Catalyst-Forge-LLC/filepress/issues"
-	},
-	"bin": {
-		"filepress": "./scripts/filepress.mjs",
-		"getfilepress": "./scripts/filepress.mjs"
-	},
-	"exports": {
-		".": {
-			"types": "./packages/core/src/lib/index.ts",
-			"svelte": "./packages/core/src/lib/index.ts",
-			"default": "./packages/core/src/lib/index.ts"
-		},
-		"./server": {
-			"types": "./packages/core/src/lib/server.ts",
-			"default": "./packages/core/src/lib/server.ts"
-		},
-		"./theme": {
-			"default": "./packages/core/src/lib/theme.ts"
-		},
-		"./package.json": "./package.json"
-	},
-	"files": [
-		"scripts/filepress.mjs",
-		"scripts/create-site.mjs",
-		"scripts/postinstall.mjs",
-		"scripts/link-embedded-packages.mjs",
-		"packages/core",
-		"packages/app",
-		"packages/import",
-		"pnpm-workspace.yaml",
-		"README.md",
-		"LICENSE"
-	],
-	"scripts": {
-		"postinstall": "node scripts/postinstall.mjs",
-		"filepress": "node scripts/filepress.mjs",
-		"test": "pnpm --filter @filepress/core test && pnpm --filter @filepress/import 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",
-		"dev": "pnpm filepress dev --site demo",
-		"dev:demo": "pnpm filepress dev --site demo",
-		"dev:www": "pnpm filepress dev --site getfilepress",
-		"create-site": "node scripts/create-site.mjs",
-		"import": "node scripts/filepress.mjs import",
-		"prepack": "node scripts/prepack.mjs",
-		"postpack": "node scripts/postpack.mjs",
-		"pack:smoke": "node scripts/pack-smoke.mjs"
-	},
-	"dependencies": {
-		"@fontsource-variable/inter": "^5.2.8",
-		"@fontsource-variable/newsreader": "^5.2.10",
-		"@sveltejs/adapter-static": "^3.0.10",
-		"@sveltejs/kit": "^2.63.0",
-		"@sveltejs/vite-plugin-svelte": "^7.1.2",
-		"@types/turndown": "^5.0.5",
-		"fast-xml-parser": "^5.2.5",
-		"gray-matter": "^4.0.3",
-		"highlight.js": "^11.11.1",
-		"linkedom": "^0.18.12",
-		"rehype-autolink-headings": "^7.1.0",
-		"rehype-highlight": "^7.0.2",
-		"rehype-raw": "^7.0.0",
-		"rehype-slug": "^6.0.0",
-		"rehype-stringify": "^10.0.1",
-		"remark-gfm": "^4.0.1",
-		"remark-parse": "^11.0.0",
-		"remark-rehype": "^11.1.2",
-		"sirv-cli": "^3.0.1",
-		"svelte": "^5.56.1",
-		"svelte-check": "^4.6.0",
-		"tsx": "^4.20.5",
-		"turndown": "^7.2.1",
-		"typescript": "^6.0.3",
-		"unified": "^11.0.5",
-		"vite": "^8.0.16"
-	},
-	"engines": {
-		"node": ">=20"
-	},
-	"packageManager": "pnpm@10.30.1",
-	"devDependencies": {
-		"wrangler": "^4.120.1"
-	}
-}
+  "name": "getfilepress",
+  "version": "0.1.4",
+  "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`.",
+  "license": "MIT",
+  "homepage": "https://getfilepress.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Catalyst-Forge-LLC/filepress.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Catalyst-Forge-LLC/filepress/issues"
+  },
+  "bin": {
+    "filepress": "./scripts/filepress.mjs",
+    "getfilepress": "./scripts/filepress.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./packages/core/src/lib/index.ts",
+      "svelte": "./packages/core/src/lib/index.ts",
+      "default": "./packages/core/src/lib/index.ts"
+    },
+    "./server": {
+      "types": "./packages/core/src/lib/server.ts",
+      "default": "./packages/core/src/lib/server.ts"
+    },
+    "./theme": {
+      "default": "./packages/core/src/lib/theme.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "scripts/filepress.mjs",
+    "scripts/copy-path-mounts.mjs",
+    "scripts/create-site.mjs",
+    "scripts/postinstall.mjs",
+    "scripts/link-embedded-packages.mjs",
+    "packages/core",
+    "packages/app",
+    "packages/import",
+    "pnpm-workspace.yaml",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@fontsource-variable/inter": "^5.2.8",
+    "@fontsource-variable/newsreader": "^5.2.10",
+    "@sveltejs/adapter-static": "^3.0.10",
+    "@sveltejs/kit": "^2.63.0",
+    "@sveltejs/vite-plugin-svelte": "^7.1.2",
+    "@types/turndown": "^5.0.5",
+    "fast-xml-parser": "^5.2.5",
+    "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",
+    "rehype-slug": "^6.0.0",
+    "rehype-stringify": "^10.0.1",
+    "remark-gfm": "^4.0.1",
+    "remark-parse": "^11.0.0",
+    "remark-rehype": "^11.1.2",
+    "sirv-cli": "^3.0.1",
+    "svelte": "^5.56.1",
+    "svelte-check": "^4.6.0",
+    "tsx": "^4.20.5",
+    "turndown": "^7.2.1",
+    "typescript": "^6.0.3",
+    "unified": "^11.0.5",
+    "vite": "^8.0.16"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "wrangler": "^4.120.1"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.mjs",
+    "filepress": "node scripts/filepress.mjs",
+    "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",
+    "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",
+    "create-site": "node scripts/create-site.mjs",
+    "import": "node scripts/filepress.mjs import",
+    "pack:smoke": "node scripts/pack-smoke.mjs"
+  }
+}

package/packages/app/README.md

@@ -0,0 +1,19 @@
+# @filepress/app
+
+The only SvelteKit application in the filepress monorepo. All routes, layouts, and
+Kit wiring live here. Content sites under [`../../sites`](../../sites) provide:
+
+- `filepress.config.ts` — identity
+- `posts/` — Markdown
+- `static/` — favicon, images (optional)
+
+## Run against a site
+
+From the repo root (do not run vite directly without `FILEPRESS_SITE_ROOT`):
+
+```bash
+pnpm filepress dev --site demo
+pnpm filepress build --site demo
+```
+
+Build output is written to `sites/<name>/build/`.

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": {