create-hollware 1.0.0-rc.1 → 1.0.0-rc.2

package/dist/index.mjs

@@ -114,6 +114,7 @@ function writeProject(io, target, choices) {
 	replaceIn(join(target, "wrangler.jsonc"), [
 		["\"name\": \"my-hollware\"", `"name": "${choices.name}"`],
 		["\"database_name\": \"my-hollware\"", `"database_name": "${choices.name}"`],
+		["\"bucket_name\": \"my-hollware-media\"", `"bucket_name": "${choices.name}-media"`],
 		["hollware-events", `${choices.name}-events`]
 	]);
 	for (const file of ["README.md"]) replaceIn(join(target, file), [["my-site", choices.site]]);
@@ -186,6 +187,7 @@ async function create(argv, io) {
 		const next = [
 			`cd ${choices.dir}`,
 			`${choices.pm} install`,
+			`${choices.pm} exec vp fmt`,
 			`${choices.pm} exec hollware migrate --local`,
 			`${choices.pm} exec hollware ${initArgs.join(" ")} --local`
 		];
@@ -206,6 +208,7 @@ async function create(argv, io) {
 	}
 	say(`Installing with ${choices.pm} ...`);
 	await step(io, "The install", choices.pm, ["install"], target);
+	await step(io, "The formatting", join(target, "node_modules", ".bin", "vp"), ["fmt"], target);
 	const hollware = join(target, "node_modules", ".bin", "hollware");
 	await step(io, "The migrations", hollware, ["migrate", "--local"], target);
 	const init = await step(io, "Making the site", hollware, [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-hollware",
-  "version": "1.0.0-rc.1",
+  "version": "1.0.0-rc.2",
   "description": "Create a new Hollware project.",
   "homepage": "https://hollware.com",
   "bugs": {

package/template/AGENTS.md

@@ -11,5 +11,10 @@ of the sites live in D1; this repository holds only the Worker.
 - Content is never edited in files here. Write it through the MCP tools (`create_draft`,
   `update_draft`, `validate`, `publish`) of the Hollware at `HOLLWARE_PUBLIC_URL` + `/mcp`.
 - Run `pnpm test` and `pnpm exec wrangler types --check` after a change of `wrangler.jsonc`, and `pnpm exec hollware doctor` when something does not work.
+- To update Hollware, move `hollware`, `@hollware/core`, `@hollware/server` and `@hollware/admin`
+  to one new version together, as exact versions
+  (`pnpm add -E hollware@X @hollware/core@X @hollware/server@X @hollware/admin@X`), read its
+  release notes, run `pnpm test`, then `pnpm exec hollware deploy`: it deploys the Worker and applies
+  the new migrations to the remote database. Migrations only move forward; content stays as it is.
 - Never commit a token. `hollware init` and `hollware token create` print one once.
 - Docs: https://hollware.com

package/template/package.json

@@ -7,6 +7,7 @@
     "dev": "vp dev",
     "build": "vp build",
     "test": "vp test",
+    "check": "vp check",
     "types": "wrangler types",
     "types:check": "wrangler types --check",
     "deploy": "hollware deploy",

package/template/test/worker.workerd.test.ts

@@ -79,6 +79,7 @@ describe('the database', () => {
 
     expect(results.map((row) => row.name)).toEqual([
       '_hollware_meta',
+      'assets',
       'audit_log',
       'auth_challenges',
       'deliveries',

package/template/vite.config.ts

@@ -2,8 +2,20 @@ import { cloudflare } from '@cloudflare/vite-plugin'
 import { adminAssets } from '@hollware/admin'
 import { defineConfig } from 'vite-plus'
 
-export default defineConfig({
-  plugins: [cloudflare()],
+/** Where `vp dev` serves Hollware: the URL of HOLLWARE_PUBLIC_URL before the first deploy. */
+const LOCAL_URL = 'http://localhost:5199'
+
+export default defineConfig(({ command }) => ({
+  plugins: [
+    cloudflare({
+      // `hollware deploy` writes the public URL into wrangler.jsonc, and the Worker answers only
+      // the Host of HOLLWARE_PUBLIC_URL: in development it is this machine's, whatever is deployed.
+      config:
+        command === 'serve'
+          ? (config) => ({ vars: { ...config.vars, HOLLWARE_PUBLIC_URL: LOCAL_URL } })
+          : undefined,
+    }),
+  ],
   // The admin's built files: served at /admin/ in development, and copied into the build, where
   // the Worker's static assets hold them.
   publicDir: adminAssets(),
@@ -15,4 +27,14 @@ export default defineConfig({
     // What you deploy is what the size budget of Hollware measures: minified.
     minify: true,
   },
-})
+  // `vp check` formats and lints the project as Hollware writes it. wrangler writes
+  // worker-configuration.d.ts, so neither touches it.
+  fmt: {
+    semi: false,
+    singleQuote: true,
+    ignorePatterns: ['dist/**', '.wrangler/**', 'worker-configuration.d.ts'],
+  },
+  lint: {
+    ignorePatterns: ['dist/**', '.wrangler/**', 'worker-configuration.d.ts'],
+  },
+}))

package/template/vitest.config.ts

@@ -17,8 +17,11 @@ export default defineConfig({
     cloudflareTest(async () => ({
       wrangler: { configPath: './wrangler.jsonc' },
       miniflare: {
-        // Read here in Node and applied inside workerd by the setup file.
         bindings: {
+          // The tests reach the Worker at localhost, whatever public URL `hollware deploy` wrote
+          // into wrangler.jsonc: it answers only the Host of HOLLWARE_PUBLIC_URL.
+          HOLLWARE_PUBLIC_URL: 'http://localhost:5199',
+          // Read here in Node and applied inside workerd by the setup file.
           TEST_MIGRATIONS: await readD1Migrations({
             projectPath: import.meta.dirname,
             migrationsDir,

package/template/worker-configuration.d.ts

@@ -1,11 +1,13 @@
 /* eslint-disable */
-// Generated by Wrangler by running `wrangler types` (hash: 8cce72e181db11068cbc639f31cd25a2)
+// Generated by Wrangler by running `wrangler types` (hash: f943445b38678ab7934813fd9b1a910b)
 // Runtime types generated with workerd@1.20261012.1 2026-10-06 global_fetch_strictly_public,no_nodejs_compat,no_nodejs_compat_v2
 interface __BaseEnv_Env {
 	OAUTH_KV: KVNamespace;
+	MEDIA: R2Bucket;
 	DB: D1Database;
 	EVENTS: Queue;
 	HOLLWARE_RATE_LIMIT: RateLimit;
+	IMAGES: ImagesBinding;
 	ASSETS: Fetcher;
 	HOLLWARE_PUBLIC_URL: "http://localhost:5199";
 }

package/template/wrangler.jsonc

@@ -59,4 +59,9 @@
       "migrations_dir": "node_modules/@hollware/server/migrations",
     },
   ],
+  // The images of the sites (ADR-038): the bucket that keeps them, which the first deploy creates,
+  // and the Images binding that converts each once when it arrives (to WebP by default). Without
+  // the binding, images are kept as they come; without the bucket, upload_asset is unavailable.
+  "r2_buckets": [{ "binding": "MEDIA", "bucket_name": "my-hollware-media" }],
+  "images": { "binding": "IMAGES" },
 }