@odla-ai/blog 0.0.1 → 0.0.2

package/README.md

@@ -37,6 +37,14 @@ Pick one with `"theme": "salt"` in `blog.config.json`. Override any theme file b
 placing a same-named file in your site's `theme/` directory. Preview all four
 against the example site with `npm run preview` (from the monorepo root).
 
+## Deploy (Cloudflare)
+
+`build()` emits a plain static directory; serve it from a Worker assets
+binding — `{ "assets": { "directory": "./dist-site" } }` in `wrangler.jsonc`,
+build before every deploy. Add a `main` worker script only when you want
+`/api/*` routes next to the static site (see `examples/demo-app` in the
+odla-ai monorepo for the full pattern, including odla-db + o11y wiring).
+
 ## Status
 
 Early. The build pipeline, themes, and example site work; CLI (`init`/`new`/`dev`/

package/llms.txt

@@ -151,6 +151,34 @@ the whole stylesheet, put them in `theme/custom.css` — the build appends it
 to the theme's CSS. Post URLs live under `config.postsPath` (default
 "posts").
 
+## Deploy (Cloudflare)
+
+The output is a plain static directory — serve it from a Worker's assets
+binding (this is what `blog init --deploy cloudflare` will generate; a
+working example lives at `examples/demo-app` in the odla-ai monorepo):
+
+```js
+// build-site.mjs — run before every deploy
+import { build } from "@odla-ai/blog";
+await build({ siteDir: "site", outDir: "dist-site" });
+```
+
+```jsonc
+// wrangler.jsonc
+{
+  "name": "my-site",
+  "main": "src/worker.ts",            // optional: only if you add /api routes
+  "compatibility_date": "2025-11-01",
+  "assets": { "directory": "./dist-site", "binding": "ASSETS", "not_found_handling": "404-page" }
+}
+```
+
+A pure-static site needs no worker code at all (`main` optional; assets serve
+directly). With a `main`, non-asset paths (e.g. `/api/*`) reach your fetch
+handler and everything else serves the site — the pattern for pairing the
+static layer with odla-db interactivity. Deploy: `wrangler deploy` after
+building. Set `config.url` to the final origin for correct canonical/RSS URLs.
+
 ## Gotchas
 
 - `blog.config.json` is plain JSON — no comments, no trailing commas.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@odla-ai/blog",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Minimal-dependency, static-first blogging platform. Files in, site out; odla-db lights up interactivity when configured.",
   "type": "module",
   "license": "MIT",