getfilepress 0.1.8 → 0.1.9

package/README.md

@@ -200,6 +200,8 @@ Any other static host works the same way: publish `build/` as the web root. The
 
 Full notes (including an agent checklist): [`docs/DEPLOY.md`](docs/DEPLOY.md) · product page: [getfilepress.com/deploy](https://getfilepress.com/deploy).
 
+If the site ships an agent skill, write the install page from [`docs/SKILL_PAGE.md`](docs/SKILL_PAGE.md) · [getfilepress.com/skill-page](https://getfilepress.com/skill-page).
+
 ## Repository layout
 
 ```
@@ -215,6 +217,12 @@ scripts/          filepress CLI and create-site scaffold
 pnpm test    # engine unit tests
 ```
 
+<!-- xfacts-nutrition-label -->
+
+## Nutrition label
+
+- **AppFacts:** [viewer](https://appfacts.dev/v#af1.eNptkkGLGzEMhf-K0dnZoVefygZKt01KYbK9lKUotjLxxmMZWzNhCPnvxZNk9tAebX9Pen7SBUYwnzRE7AkMHHyglKkU0CBTqlc9R86UGDQUQRkKGEArfiTQELylWCq2fdndCHsCc4GAsRuwqy-7KVFrs0-iVTtSENLqG474uFu3rVZfd9sNaMhDFD87-cGOnt6rj0PGns6cT2Dgpv_uBTTsh-gCZTDwywvNzafgYwcG1m0LGo5c5H4OPLhDwEzqJ3ZU4KrBUSpgfl8ggoHPZS78XprTXDtVEWdSZ9qrDwNXfcNv9J17fVGW-8SRovyHHf1CPg8-OCXMQWF0ytGoCuWR8gLLkKPjc1wsxJGyzOkoYbXFfJqfH_wQ_cGTezi5nZTlKNVMymypFB87lXyi4CMtysAWw56yHO_iLUbsSCXOogJhoaIOnNXMVasUOPUUBa5vGspol-z-CVdDHUorKN6q-xCql9G7-tW3OjofXF2ThPaEHf3p5-ZVlmLq6_JRkSXolT2SrYlCXcTihfMEBo4iqZim6bwch_2T5b5Zo2CYiqy-cO5otdmsm4-Vvv4FzW_8rQ) · [raw](https://github.com/Catalyst-Forge-LLC/filepress/blob/main/APP_FACTS.md)
+
 ## License
 
 MIT — see [LICENSE](LICENSE).

package/package.json

@@ -1,102 +1,107 @@
-{
-  "name": "getfilepress",
-  "version": "0.1.8",
-  "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/ensure-lease.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 && tsx --test scripts/sync-sibling-sites.test.ts",
-    "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": "node scripts/ensure-lease.mjs demo 5179 && pnpm filepress dev --site demo --host 0.0.0.0",
-    "dev:demo": "node scripts/ensure-lease.mjs demo 5179 && pnpm filepress dev --site demo --host 0.0.0.0",
-    "dev:www": "node scripts/ensure-lease.mjs getfilepress 5180 && pnpm filepress dev --site getfilepress --host 0.0.0.0",
-    "create-site": "node scripts/create-site.mjs",
-    "sync-siblings": "tsx scripts/sync-sibling-sites.ts",
-    "import": "node scripts/filepress.mjs import",
-    "pack:smoke": "node scripts/pack-smoke.mjs"
-  }
-}
+{
+	"name": "getfilepress",
+	"version": "0.1.9",
+	"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/ensure-lease.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 && pnpm --filter @filepress/app test && tsx --test scripts/sync-sibling-sites.test.ts",
+		"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": "node scripts/ensure-lease.mjs demo 5179 && pnpm filepress dev --site demo --host 0.0.0.0",
+		"dev:demo": "node scripts/ensure-lease.mjs demo 5179 && pnpm filepress dev --site demo --host 0.0.0.0",
+		"dev:www": "node scripts/ensure-lease.mjs getfilepress 5180 && pnpm filepress dev --site getfilepress --host 0.0.0.0",
+		"create-site": "node scripts/create-site.mjs",
+		"sync-siblings": "tsx scripts/sync-sibling-sites.ts",
+		"siblings": "tsx scripts/siblings/server.ts",
+		"import": "node scripts/filepress.mjs import",
+		"prepublishOnly": "node scripts/publish-gate.mjs",
+		"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",
+		"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"
+	},
+	"packageManager": "pnpm@10.30.1",
+	"devDependencies": {
+		"wrangler": "^4.120.1"
+	}
+}

package/packages/app/src/routes/posts/+page.server.ts

@@ -0,0 +1,12 @@
+import { redirect } from '@sveltejs/kit';
+import type { PageServerLoad } from './$types';
+import { content } from '$lib/content.server';
+import config from '$site-config';
+
+export const load: PageServerLoad = () => {
+	// Without homePage, the post index stays at `/`.
+	if (!config.homePage) {
+		redirect(302, '/');
+	}
+	return content.getIndexPage(1, config.postsPerPage);
+};

package/packages/app/src/routes/posts/+page.svelte

@@ -0,0 +1,38 @@
+<script lang="ts">
+	import type { PageData } from './$types';
+	import { PostIndex, absoluteUrl, ogImageUrl, postsIndexPath } from '@filepress/core';
+	import config from '$site-config';
+
+	let { data }: { data: PageData } = $props();
+
+	const pageTitle = $derived(`Posts — ${config.title}`);
+	const canonical = $derived(absoluteUrl(config, postsIndexPath(config)));
+	const ogImage = $derived(ogImageUrl(config));
+	const description = $derived(
+		`Posts from ${config.title}. ${config.description}`.trim()
+	);
+</script>
+
+<svelte:head>
+	<title>{pageTitle}</title>
+	<meta name="description" content={description} />
+	<link rel="canonical" href={canonical} />
+	<meta property="og:type" content="website" />
+	<meta property="og:title" content="Posts — {config.title}" />
+	<meta property="og:description" content={description} />
+	<meta property="og:url" content={canonical} />
+	{#if ogImage}
+		<meta property="og:image" content={ogImage} />
+		<meta name="twitter:card" content="summary" />
+		<meta name="twitter:image" content={ogImage} />
+	{/if}
+</svelte:head>
+
+<PostIndex
+	site={config}
+	featured={data.featured}
+	posts={data.posts}
+	page={data.page}
+	totalPages={data.totalPages}
+	indexHref={postsIndexPath(config)}
+/>

package/packages/app/src/routes/writing/+page.server.ts

@@ -1,12 +1,8 @@
 import { redirect } from '@sveltejs/kit';
 import type { PageServerLoad } from './$types';
-import { content } from '$lib/content.server';
+import { postsIndexPath } from '@filepress/core';
 import config from '$site-config';
 
 export const load: PageServerLoad = () => {
-	// Without homePage, the post index stays at `/` — keep /writing as an alias.
-	if (!config.homePage) {
-		redirect(302, '/');
-	}
-	return content.getIndexPage(1, config.postsPerPage);
+	redirect(308, postsIndexPath(config));
 };

package/packages/app/src/routes/writing/+page.svelte

@@ -1,38 +1 @@
-<script lang="ts">
-	import type { PageData } from './$types';
-	import { PostIndex, absoluteUrl, ogImageUrl, postsIndexPath } from '@filepress/core';
-	import config from '$site-config';
-
-	let { data }: { data: PageData } = $props();
-
-	const pageTitle = $derived(`Posts — ${config.title}`);
-	const canonical = $derived(absoluteUrl(config, postsIndexPath(config)));
-	const ogImage = $derived(ogImageUrl(config));
-	const description = $derived(
-		`Posts from ${config.title}. ${config.description}`.trim()
-	);
-</script>
-
-<svelte:head>
-	<title>{pageTitle}</title>
-	<meta name="description" content={description} />
-	<link rel="canonical" href={canonical} />
-	<meta property="og:type" content="website" />
-	<meta property="og:title" content="Posts — {config.title}" />
-	<meta property="og:description" content={description} />
-	<meta property="og:url" content={canonical} />
-	{#if ogImage}
-		<meta property="og:image" content={ogImage} />
-		<meta name="twitter:card" content="summary" />
-		<meta name="twitter:image" content={ogImage} />
-	{/if}
-</svelte:head>
-
-<PostIndex
-	site={config}
-	featured={data.featured}
-	posts={data.posts}
-	page={data.page}
-	totalPages={data.totalPages}
-	indexHref={postsIndexPath(config)}
-/>
+<p>Moved to <a href="/posts">/posts</a>.</p>

package/packages/core/src/lib/components/PostIndex.svelte

@@ -11,7 +11,7 @@
 		posts,
 		page = 1,
 		totalPages = 1,
-		/** Page-1 URL for the post index (`/` or `/writing`). */
+		/** Page-1 URL for the post index (`/` or `/posts`). */
 		indexHref = '/'
 	}: {
 		site: SiteConfig;

package/packages/core/src/lib/config.ts

@@ -55,7 +55,7 @@ export interface SiteConfig {
 	postsPerPage: number;
 	/**
 	 * When set, `/` renders this static page slug (`pages/<slug>.md`) and the
-	 * chronological post index moves to `/writing`.
+	 * chronological post index moves to `/posts`.
 	 */
 	homePage: string | null;
 	nav: NavItem[];
@@ -86,7 +86,7 @@ export interface SiteConfigInput {
 	ogImage?: string;
 	author?: string;
 	postsPerPage?: number;
-	/** Static page slug to show at `/` (post index then lives at `/writing`). */
+	/** Static page slug to show at `/` (post index then lives at `/posts`). */
 	homePage?: string;
 	nav?: NavItem[];
 	/** Custom footer links; replaces the default RSS + Topics row when set. */
@@ -120,7 +120,7 @@ function normalizeNavItems(items: NavItem[] | undefined): NavItem[] | null {
 
 /** Path to page 1 of the chronological post index. */
 export function postsIndexPath(site: Pick<SiteConfig, 'homePage'>): string {
-	return site.homePage ? '/writing' : '/';
+	return site.homePage ? '/posts' : '/';
 }
 
 /**
@@ -151,7 +151,7 @@ export function defineFilepressConfig(input: SiteConfigInput): SiteConfig {
 	const defaultNav: NavItem[] = homePage
 		? [
 				{ label: 'Home', href: '/' },
-				{ label: 'Posts', href: '/writing' },
+				{ label: 'Posts', href: '/posts' },
 				{ label: 'Topics', href: '/topics' }
 			]
 		: [

package/packages/core/src/lib/content/feeds.ts

@@ -69,7 +69,7 @@ export function buildSitemapXml(
 
 	const urls: { loc: string; lastmod?: string }[] = [
 		{ loc: absoluteUrl(site, '/') },
-		...(site.homePage ? [{ loc: absoluteUrl(site, '/writing') }] : []),
+		...(site.homePage ? [{ loc: absoluteUrl(site, '/posts') }] : []),
 		{ loc: absoluteUrl(site, '/topics') },
 		{ loc: absoluteUrl(site, '/tags') },
 		...extraPages,

package/packages/app/README.md

@@ -1,19 +0,0 @@
-# @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/core/README.md

@@ -1,29 +0,0 @@
-# @filepress/core
-
-The reusable filepress engine. Sites under [`../../sites`](../../sites) depend on
-it (via `workspace:*` in this monorepo) and provide their own SvelteKit routes,
-content, and `filepress.config.ts`.
-
-## Entry points
-
-- `@filepress/core` — client-safe: `PostCard`, `PostIndex`, `Newsletter`,
-  `SiteHeader`, `SiteFooter`, `defineFilepressConfig`, `absoluteUrl`,
-  `formatDate`, and shared types.
-- `@filepress/core/server` — server-only (filesystem access): `createContent`,
-  `renderMarkdown`, `buildRssXml` / `buildSitemapXml` / `buildRobotsTxt`, and the
-  content-parsing primitives. Import only from `+page.server.ts`, `+server.ts`,
-  or `*.server.ts` modules.
-- `@filepress/core/theme` — self-hosted fonts + the Essay theme CSS. Import once
-  from a site's root layout.
-
-## Why routes live in the site
-
-SvelteKit's router is per-project, so each site owns its `src/routes/`. Those
-route files stay thin: they call `createContent(...)` + core builders and render
-core components. `scripts/create-site.mjs` scaffolds them.
-
-## Testing
-
-`pnpm --filter @filepress/core test` runs the unit tests over the pure parsing
-and figure-transform logic. Type-checking of the whole library happens through
-each site's `svelte-check`.