getfilepress 0.1.29 → 0.1.31

package/README.md

@@ -8,7 +8,17 @@ Written **FilePress**. npm **`getfilepress`**. CLI **`filepress`** (same script
 
 ## Start a site
 
-From a clone of this repo:
+Shortest path: a folder with `filepress.config.ts` (`title`, `url`), `posts/*.md`, and `"getfilepress": "^0.1.29"` in `package.json`.
+
+```bash
+pnpm install
+pnpm build      # → ./build/
+pnpm preview    # serve build/, no Genie
+```
+
+`pnpm dev` is optional (Genie). FilePress does not upload `build/`.
+
+From a clone of this repo, scaffold a fuller starter:
 
 ```bash
 pnpm install
@@ -18,7 +28,7 @@ cd ../my-blog && pnpm install && pnpm dev
 
 `filepress new "Title"` stamps `posts/YYYY-MM-DD-slug.md`. Config, frontmatter, images, and commands: [Docs](https://getfilepress.com/docs).
 
-Pin CI on npm (`getfilepress` current is `0.1.19`) or a git SHA / existing tag. `link:` is local only.
+Pin CI on npm (`getfilepress` current is `0.1.29`) or a git SHA / existing tag. `link:` is local only.
 
 ## Import
 

package/package.json

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

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

@@ -1,4 +1,4 @@
-import { readdirSync, readFileSync } from 'node:fs';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import { isAbsolute, join, resolve } from 'node:path';
 import type { PostMeta, PostSource, RenderedPost } from './types';
 import { assertUniqueSlugs, ContentError, normalizeTag, parsePost } from './parse';
@@ -27,6 +27,7 @@ export interface ContentApi {
 }
 
 export interface CreateContentOptions {
+	/** Absolute or cwd-relative path to `posts/`. Missing dir → no posts (ok). */
 	contentDir: string;
 	/** Override draft listing. Default: on in Vite DEV, or when FILEPRESS_SHOW_DRAFTS is 1/true. */
 	listDrafts?: boolean;
@@ -47,6 +48,8 @@ export function resolveListDrafts(override?: boolean): boolean {
 /**
  * Build a content API bound to one content directory. This is the seam a site
  * wires up in a server-only module: `createContent({ contentDir: 'posts' })`.
+ * Absent `posts/` is fine — returns empty lists. Product sites do not need a
+ * dummy folder.
  *
  * Reads the filesystem, so it must only be imported from server code
  * (`+page.server.ts`, `+server.ts`, or a `*.server.ts` lib module). The pure
@@ -65,6 +68,11 @@ export function createContent(opts: CreateContentOptions): ContentApi {
 	function loadPostSources(): PostSource[] {
 		if (cache && import.meta.env.PROD) return cache;
 
+		if (!existsSync(dir)) {
+			cache = [];
+			return cache;
+		}
+
 		let filenames: string[];
 		try {
 			filenames = readdirSync(dir).filter((f) => f.toLowerCase().endsWith('.md'));