@portosaur/cli 0.6.2 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@portosaur/cli",
-  "version": "0.6.2",
+  "version": "0.8.0",
   "description": "CLI for Portosaur - The static Personal portfolio site generator.",
   "license": "GPL-3.0-only",
   "author": "soymadip",
@@ -26,9 +26,9 @@
   },
   "types": "./src/index.d.ts",
   "dependencies": {
-    "@portosaur/core": "^0.6.2",
-    "@portosaur/logger": "^0.6.2",
-    "@portosaur/wizard": "^0.6.2",
+    "@portosaur/core": "^0.8.0",
+    "@portosaur/logger": "^0.8.0",
+    "@portosaur/wizard": "^0.8.0",
     "commander": "^13.1.0",
     "js-yaml": "^4.1.1"
   }

package/src/templates/config.yml

@@ -1,15 +1,15 @@
 # yaml-language-server: $schema=https://soymadip.github.io/portosaur/conf-schema.json
+#
 # Portosaur Project Configuration
-# This file is filled with example values
 # Check Config Docs: https://soymadip.is-a.dev/portosaur/guide/config
 
 # Site Metadata & SEO
 site:
-  title: "{{fullName}}"
-  tagline: "Short description about you, your passion, your goals etc."
+  title: null # Defaults to {{homepage.hero.title}}
+  tagline: null # Defaults to {{homepage.hero.desc}}
 
-  favicon: "{{portoRoot}}/assets/img/svg/icon.svg"
-  social_card: "{{portoRoot}}/assets/img/social-card.jpeg"
+  favicon: null # By default, generates from {{home_page.hero.profile_pic}}
+  # social_card: "{{portoRoot}}/assets/img/social-card.jpeg"
 
   # Auto set if deploying in Github/GitLab Pages
   url: "auto"
@@ -18,20 +18,27 @@ site:
 # UI/UX & Theme Behavior
 theme:
   appearance:
-    dark_mode: true
-    disable_switch: false
+    default_theme: dark # dark | light
+    show_theme_switch: true
+    disable_project_link: false
+
+  footer:
+    enable: true
+    message: null
+    disable_project_link: false
 
   navigation:
+    breadcrumbs: true
     collapsable_sidebar: true
     hide_navbar_on_scroll: true
 
 # Page Content & Sections
 home_page:
   hero:
-    title: null # Fallback to {{site.title}}
+    title: "{{fullName}}"
     profession: "Your Profession"
-    desc: null # Fallback to {{site.tagline}}
-    profile_pic: null # Fallback to {{site.favicon}}
+    desc: "Short description about you, your passion, your goals etc."
+    profile_pic: "{{portoRoot}}/assets/img/svg/icon.svg"
 
     social:
       - name: "LinkedIn"

package/src/utils/runner.mjs

@@ -2,6 +2,7 @@ import fs from "fs";
 import path from "path";
 import { spawn } from "child_process";
 import { createRequire } from "module";
+import { hasCommand, getPortoDotDir } from "@portosaur/core";
 
 /**
  * Generates a static Docusaurus config file by evaluating the Portosaur config
@@ -14,7 +15,7 @@ import { createRequire } from "module";
  * @returns {string} The path to the generated config file.
  */
 export function writeConfigShim(UserRoot, portoPaths, context = {}) {
-  const dotDir = path.join(UserRoot, ".docusaurus", "portosaur");
+  const dotDir = getPortoDotDir(UserRoot);
 
   if (!fs.existsSync(dotDir)) {
     fs.mkdirSync(dotDir, { recursive: true });
@@ -173,8 +174,36 @@ export async function runDocusaurus(
 
   args.push(...extraArgs);
 
+  // Strip the hardcoded Docusaurus generator tag from its internal HTML templates
+  // so that only the Portosaur metadata tag is rendered in the final output.
+  try {
+    const coreLibDir = path.resolve(path.dirname(docusaurusBin), "../lib");
+    const templates = [
+      path.join(coreLibDir, "webpack/templates/dev.html.template.ejs"),
+      path.join(coreLibDir, "ssg/ssgTemplate.html.js"),
+    ];
+    for (const tpl of templates) {
+      if (fs.existsSync(tpl)) {
+        let content = fs.readFileSync(tpl, "utf8");
+        const newContent = content.replace(
+          /<meta name="generator" content="Docusaurus[^"]*">\n?/g,
+          "",
+        );
+        if (content !== newContent) {
+          fs.writeFileSync(tpl, newContent, "utf8");
+        }
+      }
+    }
+  } catch (err) {
+    // Ignore permissions or missing file errors
+  }
+
   // Use bun when available for faster builds, fall back to node.
-  const runtime = typeof Bun !== "undefined" ? "bun" : "node";
+  // If node isn't installed, fallback to bun gracefully.
+  let runtime = "node";
+  if (typeof Bun !== "undefined" || !hasCommand("node")) {
+    runtime = "bun";
+  }
 
   // Skip actual execution in test mode
   if (process.env.PORTO_TEST_MODE === "true") {
@@ -186,10 +215,6 @@ export async function runDocusaurus(
 
   const childEnv = { ...process.env, FORCE_COLOR: "true" };
 
-  if (command === "build") {
-    childEnv.CI = "true";
-  }
-
   const child = spawn(runtime, args, {
     stdio: "inherit",
     cwd: UserRoot,