getfilepress 0.1.7 → 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,6 +1,6 @@
 {
 	"name": "getfilepress",
-	"version": "0.1.7",
+	"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`.",
@@ -61,6 +61,7 @@
 		"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",

package/packages/app/src/routes/+layout.svelte

@@ -1,14 +1,23 @@
 <script lang="ts">
 	import '$lib/theme-entry';
 	import criticalTheme from '$critical-theme';
-	import { SiteHeader, SiteFooter } from '@filepress/core';
+	import { SiteHeader, SiteFooter, isPathMountHref } from '@filepress/core';
 	import config from '$site-config';
 	import GenieHost from '$lib/genie/GenieHost.svelte';
 
-
 	let { children } = $props();
+
+	function markPathMountLink(event: PointerEvent) {
+		const a = (event.target as HTMLElement | null)?.closest('a[href]');
+		if (!a) return;
+		const href = a.getAttribute('href');
+		if (!href || !isPathMountHref(href, config.paths)) return;
+		a.setAttribute('data-sveltekit-reload', '');
+	}
 </script>
 
+<svelte:window onpointerdown={markPathMountLink} />
+
 <svelte:head>
 	{#if criticalTheme}
 		{@html `<style data-filepress-critical>${criticalTheme}</style>`}

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/components/SiteFooter.svelte

@@ -1,5 +1,6 @@
 <script lang="ts">
 	import type { SiteConfig } from '../config';
+	import { isPathMountHref } from '../paths-shared';
 	import NavIcon from './NavIcon.svelte';
 
 	let { site, year = new Date().getFullYear() }: { site: SiteConfig; year?: number } = $props();
@@ -16,7 +17,9 @@
 					class:nav-github={item.icon === 'github'}
 					{...(item.icon === 'github'
 						? { target: '_blank', rel: 'noopener noreferrer' }
-						: {})}
+						: isPathMountHref(item.href, site.paths)
+							? { 'data-sveltekit-reload': true }
+							: {})}
 				>
 					{#if item.icon}
 						<NavIcon name={item.icon} />

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

@@ -1,5 +1,6 @@
 <script lang="ts">
 	import type { SiteConfig } from '../config';
+	import { isPathMountHref } from '../paths-shared';
 	import NavIcon from './NavIcon.svelte';
 
 	let { site }: { site: SiteConfig } = $props();
@@ -28,7 +29,9 @@
 					class:nav-github={item.icon === 'github'}
 					{...(item.icon === 'github'
 						? { target: '_blank', rel: 'noopener noreferrer' }
-						: {})}
+						: isPathMountHref(item.href, site.paths)
+							? { 'data-sveltekit-reload': true }
+							: {})}
 				>
 					{#if item.icon}
 						<NavIcon name={item.icon} />

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/core/src/lib/index.ts

@@ -24,6 +24,8 @@ export type {
 	PathMount
 } from './config';
 
+export { isPathMountHref } from './paths-shared';
+
 export { formatDate } from './format';
 
 export type { PostMeta, PostSource, RenderedPost, RawFrontmatter } from './content/types';

package/packages/core/src/lib/paths-shared.ts

@@ -87,3 +87,11 @@ export function normalizePathMounts(input: PathMount[] | undefined): PathMount[]
 export function pathMountReservedSlugs(mounts: PathMount[]): string[] {
 	return mounts.map((m) => m.url.slice(1).split('/')[0]!).filter(Boolean);
 }
+
+/** Same-origin href that belongs to a `paths` mount (e.g. `/docs`, `/docs/install`). */
+export function isPathMountHref(href: string, mounts: PathMount[]): boolean {
+	const raw = href.trim();
+	if (!raw.startsWith('/')) return false;
+	const path = raw.split(/[?#]/)[0] ?? '';
+	return mounts.some((m) => path === m.url || path.startsWith(`${m.url}/`));
+}

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

@@ -12,7 +12,7 @@ import { join, relative, resolve, sep } from 'node:path';
 import type { PathMount } from './paths-shared';
 
 export type { PathMount } from './paths-shared';
-export { normalizePathMounts, pathMountReservedSlugs } from './paths-shared';
+export { normalizePathMounts, pathMountReservedSlugs, isPathMountHref } from './paths-shared';
 
 /** Absolute filesystem path for a mount's source directory. */
 export function resolvePathMountDir(siteRoot: string, mount: PathMount): string {