getfilepress

FilePress

Markdown blogs from git. No CMS. No database. A static build/ folder.

Written FilePress. npm getfilepress. CLI filepress (same script as getfilepress).

Site: getfilepress.com · Docs: getfilepress.com/docs

Start a site

Shortest path: three files in an empty folder.

package.json:

{
  "type": "module",
  "scripts": {
    "dev": "filepress dev",
    "build": "filepress build",
    "preview": "filepress preview"
  },
  "devDependencies": { "getfilepress": "^0.1.37" }
}

filepress.config.ts (title and url are required):

import { defineFilepressConfig } from 'getfilepress';

export default defineFilepressConfig({
  title: 'My Blog',
  url: 'https://my.blog',
  logo: null
});

posts/2026-09-10-hello.md (title and date are required):

---
title: Hello
date: 2026-09-10
---

First post.

Then:

pnpm install
pnpm build      # → ./build/
pnpm preview    # serve build/ at http://127.0.0.1:27777, no Genie

logo: null gives a text title. Without it, the masthead links /logo.png and the build fails until static/logo.png exists.

pnpm dev is optional (Genie). FilePress does not upload build/.

From a clone of this repo, scaffold a fuller starter:

pnpm install
pnpm create-site my-blog --external ../my-blog --title "My Blog" --url https://my.blog
cd ../my-blog && pnpm install && pnpm dev

filepress new "Title" stamps posts/YYYY-MM-DD-slug.md. Config, frontmatter, images, and commands: Docs.

Pin CI on npm (getfilepress current is 0.1.37) or a git SHA / existing tag. link: is local only.

Import

pnpm filepress import --source https://example.com --yes
pnpm filepress import --source https://example.com --dry-run --no-llm

Crawls a public site (sitemap/RSS preferred) into a sibling content tree. Optional --inspire URLs (up to three) and Ollama. --no-llm stays deterministic. Import · spec.

Docs

Topic	Where
Scaffold, config, posts	Docs · getting started
Theme tokens and presets	docs/THEME.md
Genie (dev only)	Genie · spec
Deploy	Deploy · docs/DEPLOY.md
Sibling / external sites	docs/EXTERNAL_SITES.md
Local ports	docs/LOCALSLIP.md
Agent skill page	Skill page · docs/SKILL_PAGE.md

In this repo

• sites/demo — engine fixture (drafts, scheduled posts, image convention)
• sites/getfilepress — getfilepress.com

pnpm install
pnpm test
pnpm dev        # demo
pnpm dev:www    # product site
pnpm ship       # build getfilepress + Wrangler Pages

Not a CMS

No admin UI. No visitor comments — permanent. Genie is filepress dev only; preview and build/ do not include it. Production is files.

xFacts label

• AppFacts: viewer · raw

License

MIT. Copyright Catalyst Forge LLC.

See the rest of the Catalyst Forge shelf.