create-boject-cms 0.0.1-rc.1 → 0.0.1-rc.2

package/LICENSE

@@ -9,7 +9,7 @@ Parameters
 
 Licensor:             Boject Ltd
 
-Licensed Work:        boject-cms 0.0.1-rc.1
+Licensed Work:        boject-cms 0.0.1-rc.2
                       The Licensed Work is © 2026 Boject Ltd.
 
 Additional Use Grant: You may make production use of the Licensed Work,

package/README.md

@@ -27,9 +27,14 @@ Non-interactive use:
 ```bash
 pnpm create boject-cms my-site --starter base
 pnpm create boject-cms my-site --starter base --image ghcr.io/bojectify/boject-cms:1.4.2
+pnpm create boject-cms my-site --starter base --port 4100   # host port (default 4000)
 pnpm create boject-cms my-site --force            # scaffold into a non-empty directory
 ```
 
+The CMS is published on host port **4000** by default. Pass `--port <n>` at
+scaffold time (or edit `BOJECT_HOST_PORT` in the generated `.env` afterwards) to
+run several projects on one machine, or to avoid a clash with another service.
+
 ## What gets scaffolded
 
 ```
@@ -73,6 +78,7 @@ Once the container is healthy, log in at http://localhost:4000/login. The admin
 | `BOJECT_ADMIN_EMAIL`                     | Initial admin (`admin@local`).                                                                                   |
 | `BOJECT_ADMIN_PASSWORD`                  | 16-byte random initial admin password.                                                                           |
 | `STORAGE_DRIVER`                         | `local` (default), `s3`, or `r2`.                                                                                |
+| `BOJECT_HOST_PORT`                       | Host port the CMS is published on (default 4000; Compose maps it to container port 3000).                        |
 | `BOJECT_SCHEMA_DIR`                      | `/app/content-types` — the entrypoint applies any `*.boject.json` here on every boot.                            |
 | `BOJECT_INITIAL_STARTER`                 | First-boot starter path (`/starters/<starter>.boject.json`).                                                     |
 | `# BOJECT_SCHEMA_READONLY=true`          | Commented. Set on production / staging to disable schema editing in the UI.                                      |

package/dist/index.js

@@ -5,6 +5,21 @@ import { fileURLToPath } from "url";
 import { dirname, join as join2, resolve } from "path";
 import { parseArgs } from "util";
 
+// src/hostPort.ts
+var DEFAULT_HOST_PORT = 4e3;
+function resolveHostPort(flag) {
+  if (flag === void 0) {
+    return DEFAULT_HOST_PORT;
+  }
+  const port = Number(flag);
+  if (!Number.isInteger(port) || port < 1 || port > 65535) {
+    throw new Error(
+      `Invalid --port "${flag}": expected an integer between 1 and 65535.`
+    );
+  }
+  return port;
+}
+
 // src/prompts.ts
 import { isCancel, select } from "@clack/prompts";
 var CHOICES = ["base", "sport", "rugby", "none"];
@@ -46,7 +61,7 @@ async function resolveStarter({
 }
 
 // src/version.ts
-var IMAGE_TAG = "ghcr.io/bojectify/boject-cms:0.0.1-rc.1";
+var IMAGE_TAG = "ghcr.io/bojectify/boject-cms:0.0.1-rc.2";
 
 // src/writeProject.ts
 import { copyFile, mkdir, readdir, writeFile } from "fs/promises";
@@ -64,11 +79,15 @@ function renderDockerCompose({
     image: ${imageTag}
     restart: unless-stopped
     ports:
-      - '4000:3000'
+      # Host port comes from BOJECT_HOST_PORT in .env (default 4000). Change it
+      # there to run several projects side by side or dodge a port clash.
+      - '\${BOJECT_HOST_PORT:-4000}:3000'
     env_file:
       - .env
     depends_on:
       - db
+      - meilisearch
+      - redis
     volumes:
       - storage:/app/storage
       - ./content-types:/app/content-types:ro
@@ -82,9 +101,31 @@ ${starterMount}  db:
     volumes:
       - pgdata:/var/lib/postgresql/data
 
+  meilisearch:
+    image: getmeili/meilisearch:v1.45.2
+    restart: unless-stopped
+    environment:
+      # Production mode: all routes require the master key. The CMS reads the
+      # same key from .env (MEILI_MASTER_KEY). Compose interpolates it here.
+      MEILI_ENV: production
+      MEILI_MASTER_KEY: \${MEILI_MASTER_KEY}
+      MEILI_NO_ANALYTICS: 'true'
+    volumes:
+      # The search index must survive restarts, else search is empty until a
+      # manual \`pnpm search:reindex\`.
+      - meilidata:/meili_data
+
+  redis:
+    image: redis:7.4-alpine
+    restart: unless-stopped
+    # Cache only \u2014 no persistence, no volume. Restarts cold by design
+    # (repopulates from Postgres).
+    command: redis-server --save "" --appendonly no
+
 volumes:
   pgdata:
   storage:
+  meilidata:
 `;
 }
 
@@ -92,10 +133,16 @@ volumes:
 function renderEnvFile({
   sessionPassword,
   adminPassword,
-  starter
+  meiliMasterKey,
+  starter,
+  hostPort
 }) {
   const lines = [
     "DATABASE_URL=postgresql://boject:boject@db:5432/boject",
+    "# Search (Meilisearch) + cache (Redis) sidecars \u2014 see docker-compose.yml.",
+    "MEILI_URL=http://meilisearch:7700",
+    `MEILI_MASTER_KEY=${meiliMasterKey}`,
+    "REDIS_URL=redis://redis:6379",
     `NUXT_SESSION_PASSWORD=${sessionPassword}`,
     "BOJECT_ADMIN_EMAIL=admin@local",
     `BOJECT_ADMIN_PASSWORD=${adminPassword}`,
@@ -106,6 +153,10 @@ function renderEnvFile({
     lines.push(`BOJECT_INITIAL_STARTER=/starters/${starter}.boject.json`);
   }
   lines.push(
+    "",
+    "# Host port the CMS is published on (mapped to the container port 3000).",
+    "# Change it to run several projects side by side, or to avoid a port clash.",
+    `BOJECT_HOST_PORT=${hostPort}`,
     "",
     '# Set to "true" on production / staging to disable schema editing in the UI.',
     "# Schema changes should flow from git on locked environments.",
@@ -141,7 +192,11 @@ function renderPackageJson({ name }) {
 }
 
 // src/templates/readme.ts
-function renderReadme({ starter, adminEmail }) {
+function renderReadme({
+  starter,
+  adminEmail,
+  hostPort
+}) {
   const starterLine = starter === "none" ? "" : `The \`${starter}\` starter bundle will be imported on first boot.
 
 `;
@@ -155,11 +210,17 @@ A new boject-cms project scaffolded by \`create-boject-cms\`.
 docker compose up -d
 \`\`\`
 
-${starterLine}Once the container is healthy, log in at http://localhost:4000/login with:
+This starts four services: the CMS, PostgreSQL, Meilisearch (search), and Redis
+(response cache).
+
+${starterLine}Once the container is healthy, log in at http://localhost:${hostPort}/login with:
 
 - Email: \`${adminEmail}\`
 - Password: see \`BOJECT_ADMIN_PASSWORD\` in \`.env\`
 
+The CMS is published on host port \`${hostPort}\` \u2014 change \`BOJECT_HOST_PORT\` in
+\`.env\` to run several projects side by side or to avoid a port clash.
+
 ## Content types
 
 Your content type schema lives in \`content-types/schema.boject.json\` and is
@@ -231,6 +292,9 @@ function generateSessionPassword() {
 function generateAdminPassword() {
   return randomBytes(16).toString("base64");
 }
+function generateMeiliMasterKey() {
+  return randomBytes(32).toString("base64");
+}
 
 // src/writeProject.ts
 async function writeProject({
@@ -238,7 +302,8 @@ async function writeProject({
   starter,
   imageTag,
   force,
-  startersSourceDir
+  startersSourceDir,
+  hostPort
 }) {
   await mkdir(targetDir, { recursive: true });
   const existing = await readdir(targetDir);
@@ -249,6 +314,7 @@ async function writeProject({
   }
   const sessionPassword = generateSessionPassword();
   const adminPassword = generateAdminPassword();
+  const meiliMasterKey = generateMeiliMasterKey();
   const adminEmail = "admin@local";
   const projectName = sanitiseProjectName(basename(targetDir));
   await writeFile(
@@ -257,7 +323,13 @@ async function writeProject({
   );
   await writeFile(
     join(targetDir, ".env"),
-    renderEnvFile({ sessionPassword, adminPassword, starter })
+    renderEnvFile({
+      sessionPassword,
+      adminPassword,
+      meiliMasterKey,
+      starter,
+      hostPort
+    })
   );
   await writeFile(
     join(targetDir, "package.json"),
@@ -266,7 +338,7 @@ async function writeProject({
   await writeFile(join(targetDir, ".gitignore"), GITIGNORE);
   await writeFile(
     join(targetDir, "README.md"),
-    renderReadme({ starter, adminEmail })
+    renderReadme({ starter, adminEmail, hostPort })
   );
   if (starter !== "none") {
     const startersTarget = join(targetDir, "starters");
@@ -301,12 +373,13 @@ function parseCli(argv) {
     options: {
       force: { type: "boolean", default: false },
       starter: { type: "string" },
-      image: { type: "string" }
+      image: { type: "string" },
+      port: { type: "string" }
     }
   });
   if (positionals.length !== 1) {
     process.stderr.write(
-      "Usage: create-boject-cms <target-dir> [--force] [--starter <name>] [--image <tag>]\n"
+      "Usage: create-boject-cms <target-dir> [--force] [--starter <name>] [--image <tag>] [--port <n>]\n"
     );
     process.exit(1);
   }
@@ -314,7 +387,8 @@ function parseCli(argv) {
     targetDir: resolve(positionals[0]),
     force: values.force === true,
     starter: values.starter,
-    imageTag: values.image ?? IMAGE_TAG
+    imageTag: values.image ?? IMAGE_TAG,
+    hostPort: resolveHostPort(values.port)
   };
 }
 function resolveStartersSourceDir() {
@@ -326,7 +400,8 @@ async function main() {
     targetDir,
     force,
     starter: starterFlag,
-    imageTag
+    imageTag,
+    hostPort
   } = parseCli(process.argv.slice(2));
   const starter = await resolveStarter({
     flag: starterFlag,
@@ -337,7 +412,8 @@ async function main() {
     starter,
     imageTag,
     force,
-    startersSourceDir: resolveStartersSourceDir()
+    startersSourceDir: resolveStartersSourceDir(),
+    hostPort
   });
   process.stdout.write(`
 Scaffolded boject-cms project at ${targetDir}
@@ -346,7 +422,7 @@ Next steps:
   cd ${targetDir}
   docker compose up -d
 
-Once the container is healthy, log in at http://localhost:4000/login with:
+Once the container is healthy, log in at http://localhost:${hostPort}/login with:
   Email:    ${adminEmail}
   Password: ${adminPassword}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-boject-cms",
-  "version": "0.0.1-rc.1",
+  "version": "0.0.1-rc.2",
   "license": "BUSL-1.1",
   "private": false,
   "type": "module",