ctheme 0.1.1 → 0.1.3

package/DEVELOPMENT.md

@@ -55,6 +55,7 @@ Relevant env vars:
 CTHEME_HOME
 CTHEME_THEME_DIR
 CTHEME_SNIPPET_DIR
+CTHEME_SKIP_FONT_BOOTSTRAP
 ```
 
 ## Command Map
@@ -145,6 +146,22 @@ Google Fonts install flow:
 
 Do not bundle font files in the repo.
 
+### 6. Install Bootstrap
+
+`npm install -g ctheme` runs `scripts/postinstall.js`.
+
+That script:
+
+- runs on macOS only
+- best-effort installs the curated default font pack
+- never hard-fails the package install because of a font download problem
+
+Skip it with:
+
+```bash
+CTHEME_SKIP_FONT_BOOTSTRAP=1 npm install -g ctheme
+```
+
 ## Local Development
 
 Install the CLI locally:

package/README.md

@@ -18,6 +18,12 @@ From npm:
 npm install -g ctheme
 ```
 
+On macOS, install also preloads the curated default font pack used by the bundled themes. If you want to skip that during install:
+
+```bash
+CTHEME_SKIP_FONT_BOOTSTRAP=1 npm install -g ctheme
+```
+
 From GitHub:
 
 ```bash
@@ -71,7 +77,7 @@ The wizard walks through:
 - terminal font
 - UI font
 - code font
-- theme summary before save
+- theme summary with color swatches before save
 - optional Google Fonts install
 - optional live apply
 
@@ -150,6 +156,7 @@ solarized, solarized-dark, velvet
 ```
 
 Bundled themes intentionally vary their font pairings so they do not all feel the same.
+The npm install bootstrap preinstalls the curated font set those presets rely on, so the bundled themes render correctly immediately on macOS.
 
 ## Contributing
 

package/bin/ctheme.js

@@ -94,9 +94,9 @@ const BUILTIN_THEMES = [
 ];
 
 const FONT_CHOICES = {
-  ui: ["Manrope", "Space Grotesk", "Outfit", "Sora", "Plus Jakarta Sans", "Newsreader", "Fraunces"],
-  code: ["IBM Plex Mono", "Space Mono", "DM Mono", "Source Code Pro", "Fira Code", "JetBrains Mono"],
-  terminal: ["IBM Plex Mono", "Space Mono", "DM Mono", "Source Code Pro", "Fira Code", "JetBrains Mono"]
+  ui: ["Manrope", "Space Grotesk", "Outfit", "Sora", "Plus Jakarta Sans", "Newsreader", "Fraunces", "Bricolage Grotesque", "Urbanist", "Source Sans 3", "IBM Plex Sans", "Instrument Serif", "Syne"],
+  code: ["IBM Plex Mono", "Space Mono", "DM Mono", "Source Code Pro", "Fira Code", "JetBrains Mono", "Roboto Mono", "Azeret Mono", "Victor Mono", "Ubuntu Mono"],
+  terminal: ["IBM Plex Mono", "Space Mono", "DM Mono", "Source Code Pro", "Fira Code", "JetBrains Mono", "Roboto Mono", "Azeret Mono", "Victor Mono", "Ubuntu Mono"]
 };
 
 const PRESETS = {
@@ -117,7 +117,7 @@ const PRESETS = {
     cyan: "#39c5cf"
   },
   paper: {
-    fonts: { terminal: "IBM Plex Mono", ui: "Newsreader", code: "IBM Plex Mono" },
+    fonts: { terminal: "Source Code Pro", ui: "Newsreader", code: "Source Code Pro" },
     accent: "#005cc5",
     bg: "#fff8e8",
     surface: "#fffdf7",
@@ -149,7 +149,7 @@ const PRESETS = {
     cyan: "#7dcfff"
   },
   mint: {
-    fonts: { terminal: "JetBrains Mono", ui: "Plus Jakarta Sans", code: "JetBrains Mono" },
+    fonts: { terminal: "Roboto Mono", ui: "Plus Jakarta Sans", code: "Roboto Mono" },
     accent: "#2bb673",
     bg: "#081411",
     surface: "#10201b",
@@ -165,7 +165,7 @@ const PRESETS = {
     cyan: "#5ad1e6"
   },
   obsidian: {
-    fonts: { terminal: "IBM Plex Mono", ui: "Outfit", code: "IBM Plex Mono" },
+    fonts: { terminal: "Azeret Mono", ui: "Outfit", code: "Azeret Mono" },
     accent: "#58a6ff",
     bg: "#05070a",
     surface: "#0e131a",
@@ -181,7 +181,7 @@ const PRESETS = {
     cyan: "#7dd3fc"
   },
   glacier: {
-    fonts: { terminal: "Space Mono", ui: "Space Grotesk", code: "Space Mono" },
+    fonts: { terminal: "Space Mono", ui: "Urbanist", code: "Space Mono" },
     accent: "#7aa2f7",
     bg: "#0a1220",
     surface: "#121c2f",
@@ -197,7 +197,7 @@ const PRESETS = {
     cyan: "#7dcfff"
   },
   cobalt: {
-    fonts: { terminal: "Space Mono", ui: "Sora", code: "Space Mono" },
+    fonts: { terminal: "Victor Mono", ui: "Bricolage Grotesque", code: "Victor Mono" },
     accent: "#4da3ff",
     bg: "#09111f",
     surface: "#10203a",
@@ -229,7 +229,7 @@ const PRESETS = {
     cyan: "#8bd3dd"
   },
   lotus: {
-    fonts: { terminal: "IBM Plex Mono", ui: "Newsreader", code: "IBM Plex Mono" },
+    fonts: { terminal: "Ubuntu Mono", ui: "Instrument Serif", code: "Ubuntu Mono" },
     accent: "#d16d9e",
     bg: "#fff7f3",
     surface: "#fffdfb",
@@ -245,7 +245,7 @@ const PRESETS = {
     cyan: "#4d8ca1"
   },
   dune: {
-    fonts: { terminal: "JetBrains Mono", ui: "Sora", code: "JetBrains Mono" },
+    fonts: { terminal: "Fira Code", ui: "Syne", code: "Fira Code" },
     accent: "#d97706",
     bg: "#16110c",
     surface: "#231912",
@@ -261,7 +261,7 @@ const PRESETS = {
     cyan: "#67e8f9"
   },
   forest: {
-    fonts: { terminal: "IBM Plex Mono", ui: "Newsreader", code: "IBM Plex Mono" },
+    fonts: { terminal: "IBM Plex Mono", ui: "IBM Plex Sans", code: "IBM Plex Mono" },
     accent: "#7ccf7a",
     bg: "#08100b",
     surface: "#112016",
@@ -277,7 +277,7 @@ const PRESETS = {
     cyan: "#6ee7b7"
   },
   aurora: {
-    fonts: { terminal: "Space Mono", ui: "Outfit", code: "Space Mono" },
+    fonts: { terminal: "Space Mono", ui: "Urbanist", code: "Space Mono" },
     accent: "#7c5cff",
     bg: "#0f0a1f",
     surface: "#181131",
@@ -293,7 +293,7 @@ const PRESETS = {
     cyan: "#7bdff2"
   },
   espresso: {
-    fonts: { terminal: "DM Mono", ui: "Fraunces", code: "DM Mono" },
+    fonts: { terminal: "Victor Mono", ui: "Instrument Serif", code: "Victor Mono" },
     accent: "#c67c4e",
     bg: "#120d0b",
     surface: "#1d1512",
@@ -325,7 +325,7 @@ const PRESETS = {
     cyan: "#bde0fe"
   },
   neon: {
-    fonts: { terminal: "Space Mono", ui: "Space Grotesk", code: "Space Mono" },
+    fonts: { terminal: "Azeret Mono", ui: "Bricolage Grotesque", code: "Azeret Mono" },
     accent: "#00f5d4",
     bg: "#090414",
     surface: "#130a24",
@@ -341,7 +341,7 @@ const PRESETS = {
     cyan: "#00bbf9"
   },
   harbor: {
-    fonts: { terminal: "IBM Plex Mono", ui: "Plus Jakarta Sans", code: "IBM Plex Mono" },
+    fonts: { terminal: "Roboto Mono", ui: "Plus Jakarta Sans", code: "Roboto Mono" },
     accent: "#3ba4c9",
     bg: "#f4f8fb",
     surface: "#ffffff",
@@ -389,7 +389,7 @@ const PRESETS = {
     cyan: "#2aa198"
   },
   velvet: {
-    fonts: { terminal: "DM Mono", ui: "Fraunces", code: "DM Mono" },
+    fonts: { terminal: "Ubuntu Mono", ui: "Fraunces", code: "Ubuntu Mono" },
     accent: "#d4a5ff",
     bg: "#140d18",
     surface: "#211328",
@@ -912,6 +912,10 @@ function listInstalledFonts() {
 }
 
 function installGoogleFont(family) {
+  return installGoogleFontWithOptions(family, {});
+}
+
+function installGoogleFontWithOptions(family, options = {}) {
   const paths = getThemePaths();
   ensureDir(paths.managedFontDir);
   const installed = downloadGoogleFontFiles(family, paths.managedFontDir);
@@ -919,13 +923,13 @@ function installGoogleFont(family) {
     fail(`No installable font files found for ${family}`);
   }
 
-  console.log(`Installed ${family} into ${paths.managedFontDir}`);
-  for (const file of installed) {
-    console.log(`- ${file}`);
-  }
-  if (!looksMonospaceFamily(family)) {
-    console.log("Warning: this family looks proportional. It may render poorly in terminal grids.");
+  if (!options.quiet) {
+    console.log(`Installed ${family} into ${paths.managedFontDir}`);
+    for (const file of installed) {
+      console.log(`- ${file}`);
+    }
   }
+  return installed;
 }
 
 function searchGoogleFonts(query) {
@@ -951,8 +955,7 @@ function searchGoogleFonts(query) {
   }
 
   for (const font of matches) {
-    const mono = looksMonospaceFamily(font.family) ? "mono-ish" : "proportional";
-    console.log(`${font.family}  (${mono})`);
+    console.log(font.family);
   }
 }
 
@@ -993,12 +996,13 @@ function downloadGoogleFontFiles(family, targetDir) {
     execFileSync("curl", [
       "-L",
       "--fail",
+      "-sS",
       "-H",
       "User-Agent: pretty-code",
       "--output",
       destPath,
       entry.download_url
-    ], { stdio: "inherit" });
+    ], { stdio: "pipe" });
     installed.push(destPath);
   }
 
@@ -1209,30 +1213,39 @@ async function promptYesNo(rl, label, defaultValue) {
 }
 
 function installFontsBestEffort(fonts) {
+  const installedFamilies = [];
   for (const family of [...new Set(fonts.filter(Boolean))]) {
     try {
-      installGoogleFont(family);
+      installGoogleFontWithOptions(family, { quiet: true });
+      installedFamilies.push(family);
     } catch (error) {
-      console.log(`Skipped Google Fonts install for ${family}: ${error instanceof Error ? error.message : String(error)}`);
+      console.log(`Skipped ${family}`);
     }
   }
+  if (installedFamilies.length) {
+    console.log(`Installed fonts: ${installedFamilies.join(", ")}`);
+  }
 }
 
 function printThemeSummary(theme) {
   console.log(`  name: ${theme.name}`);
   console.log(`  preset: ${theme.preset}`);
-  console.log(`  accent: ${theme.accent}`);
-  console.log(`  bg: ${theme.bg}`);
-  console.log(`  surface: ${theme.surface}`);
-  console.log(`  surface alt: ${theme.surfaceAlt}`);
-  console.log(`  text: ${theme.fg}`);
-  console.log(`  muted: ${theme.muted}`);
-  console.log(`  dim: ${theme.dim}`);
+  printColorLine("accent", theme.accent);
+  printColorLine("bg", theme.bg);
+  printColorLine("surface", theme.surface);
+  printColorLine("surface alt", theme.surfaceAlt);
+  printColorLine("text", theme.fg);
+  printColorLine("muted", theme.muted);
+  printColorLine("dim", theme.dim);
   console.log(`  terminal font: ${theme.fonts.terminal}`);
   console.log(`  ui font: ${theme.fonts.ui}`);
   console.log(`  code font: ${theme.fonts.code}`);
 }
 
+function printColorLine(label, hex) {
+  console.log(`  ${label}: ${colorBlock(hex, 8)} ${hex}`);
+}
+
 function writeThemeAssets(paths, name, palette) {
   ensureDir(paths.paletteDir);
   fs.writeFileSync(path.join(paths.paletteDir, `${name}.json`), `${JSON.stringify(palette, null, 2)}\n`, "utf8");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ctheme",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Theme manager for making terminals look better with colors, fonts, and live profile switching",
   "license": "MIT",
   "repository": {
@@ -21,13 +21,15 @@
   "files": [
     "bin",
     "DEVELOPMENT.md",
-    "README.md"
+    "README.md",
+    "scripts"
   ],
   "bin": {
     "ctheme": "bin/ctheme.js"
   },
   "scripts": {
-    "test": "node ./bin/ctheme.js --help"
+    "test": "node ./bin/ctheme.js --help",
+    "postinstall": "node ./scripts/postinstall.js"
   },
   "engines": {
     "node": ">=18"

package/scripts/postinstall.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("child_process");
+const path = require("path");
+
+const DEFAULT_FONTS = [
+  "Azeret Mono",
+  "Bricolage Grotesque",
+  "DM Mono",
+  "Fira Code",
+  "Fraunces",
+  "IBM Plex Mono",
+  "IBM Plex Sans",
+  "Instrument Serif",
+  "JetBrains Mono",
+  "Newsreader",
+  "Outfit",
+  "Plus Jakarta Sans",
+  "Roboto Mono",
+  "Sora",
+  "Source Code Pro",
+  "Source Sans 3",
+  "Space Grotesk",
+  "Space Mono",
+  "Syne",
+  "Ubuntu Mono",
+  "Urbanist",
+  "Victor Mono"
+];
+
+if (process.env.CTHEME_SKIP_FONT_BOOTSTRAP === "1") {
+  console.log("ctheme: skipping default font bootstrap");
+  process.exit(0);
+}
+
+if (process.platform !== "darwin") {
+  console.log("ctheme: skipping default font bootstrap on non-macOS");
+  process.exit(0);
+}
+
+const cliPath = path.join(__dirname, "..", "bin", "ctheme.js");
+console.log(`ctheme: installing bundled default fonts (${DEFAULT_FONTS.length})`);
+
+for (const family of DEFAULT_FONTS) {
+  const result = spawnSync(process.execPath, [cliPath, "font", "install", family], {
+    stdio: "inherit",
+    env: {
+      ...process.env,
+      CTHEME_SKIP_FONT_BOOTSTRAP: "1"
+    }
+  });
+
+  if (result.status !== 0) {
+    console.log(`ctheme: skipped ${family}`);
+  }
+}
+