@archetypeai/ds-cli 0.3.17 → 0.3.18

package/README.md

@@ -26,13 +26,19 @@ Sets up a SvelteKit + Tailwind v4 + shadcn-svelte project with design tokens, co
 |------|--------|---------|
 | `--framework` | `svelte` | prompt |
 | `--pm` | `npm`, `pnpm`, `bun`, `yarn` | prompt |
+| `--fonts <path>` | path to PP Neue Montreal fonts folder | prompt |
+| `--no-fonts` | skip font installation (use system fallback) | — |
 | `--no-components` | skip component install | install all |
 | `--codeagent` | `cursor`, `claude`, `none` | prompt |
+| `--defaults` | force non-interactive mode | — |
 
 ```bash
-npx @archetypeai/ds-cli create my-app --framework svelte --pm pnpm --codeagent none
+npx @archetypeai/ds-cli create my-app --pm pnpm --no-fonts --codeagent claude
+npx @archetypeai/ds-cli create my-app --pm npm --fonts /path/to/fonts --codeagent claude
 ```
 
+**Non-interactive mode** (no TTY or `--defaults`): all required flags must be specified. The CLI lists missing options and exits so agents can ask the user before proceeding.
+
 ---
 
 ### `init` → Add DS to an existing project
@@ -47,11 +53,15 @@ Run from a SvelteKit project root. Auto-detects your package manager, installs t
 | Flag | Values | Default |
 |------|--------|---------|
 | `--pm` | `npm`, `pnpm`, `bun`, `yarn` | auto-detect |
+| `--fonts <path>` | path to PP Neue Montreal fonts folder | prompt |
+| `--no-fonts` | skip font installation (use system fallback) | — |
 | `--no-components` | skip component install | install all |
 | `--codeagent` | `cursor`, `claude`, `none` | prompt |
+| `--defaults` | force non-interactive mode | — |
 
 ```bash
-npx @archetypeai/ds-cli init --pm npm --codeagent none
+npx @archetypeai/ds-cli init --pm npm --no-fonts --codeagent claude
+npx @archetypeai/ds-cli init --pm npm --fonts /path/to/fonts --codeagent claude
 ```
 
 ---

package/bin.js

@@ -28,19 +28,22 @@ Usage:
 Create flags:
   --framework <svelte>              Framework to use (default: prompt)
   --pm <npm|pnpm|bun|yarn>          Package manager (default: prompt)
-  --fonts / --no-fonts              Install internal fonts (default: prompt)
+  --fonts <path>                    Install fonts from local folder
+  --no-fonts                        Skip font installation
   --no-components                   Skip component installation (default: install all)
   --codeagent <cursor|claude|none>  Agent configuration (default: prompt)
   --defaults                        Skip prompts, use sensible defaults
 
 Init flags:
   --pm <npm|pnpm|bun|yarn>          Package manager (default: auto-detect)
-  --fonts / --no-fonts              Install internal fonts (default: prompt)
+  --fonts <path>                    Install fonts from local folder
+  --no-fonts                        Skip font installation
   --no-components                   Skip component installation (default: install all)
   --codeagent <cursor|claude|none>  Agent configuration (default: prompt)
-  --defaults                        Skip prompts, use sensible defaults
+  --defaults                        Force non-interactive mode
 
-Non-interactive shells (no TTY) automatically use defaults.
+Non-interactive mode (no TTY or --defaults):
+  All required options must be specified via flags. Missing options are listed and the CLI exits.
 
 Add targets:
   ds-ui-svelte                      Install all design system components

package/commands/create.js

@@ -14,7 +14,8 @@ import {
   createDemoPage,
   installAgentConfig
 } from '../lib/scaffold-ds-svelte-project.js';
-import { isInteractive, DEFAULTS, logDefaultsNotice } from '../lib/is-interactive.js';
+import { validateFontsPath, installLocalFonts } from '../lib/install-fonts-local.js';
+import { isInteractive, DEFAULTS } from '../lib/is-interactive.js';
 
 // parse flags
 export function parseFlags(args) {
@@ -22,6 +23,7 @@ export function parseFlags(args) {
     name: null,
     framework: null,
     pm: null,
+    fonts: null,
     components: true,
     agent: null,
     defaults: false
@@ -33,6 +35,10 @@ export function parseFlags(args) {
       flags.framework = args[++i];
     } else if (arg === '--pm' && args[i + 1]) {
       flags.pm = args[++i];
+    } else if (arg === '--fonts' && args[i + 1]) {
+      flags.fonts = args[++i];
+    } else if (arg === '--no-fonts') {
+      flags.fonts = false;
     } else if (arg === '--no-components') {
       flags.components = false;
     } else if (arg === '--codeagent' && args[i + 1]) {
@@ -52,6 +58,30 @@ export async function create(args) {
   const flags = parseFlags(args);
   const interactive = isInteractive(flags);
 
+  // preflight: in non-interactive mode, list all unspecified options and exit
+  if (!interactive) {
+    const missing = [];
+    if (!flags.name)
+      missing.push('  <project-name>                     Project name (positional argument)');
+    if (!flags.pm) missing.push('  --pm <npm (default)|pnpm|bun|yarn> Package manager');
+    if (flags.fonts === null)
+      missing.push('  --fonts <path> | --no-fonts        Internal fonts (PP Neue Montreal)');
+    if (!flags.agent) missing.push('  --codeagent <cursor|claude|none>   AI agent configuration');
+
+    if (missing.length > 0) {
+      console.log(
+        '[CONFIGURATION REQUIRED] Do not assume defaults. Ask the user to choose each option:\n\n' +
+          missing.join('\n') +
+          '\n\nOptional:\n' +
+          '  --no-components                    Skip component installation\n\n' +
+          'Once the user has answered, re-run with their choices:\n' +
+          '  ds create my-app --pm <choice> --fonts <path> --codeagent <choice>\n' +
+          '  ds create my-app --pm <choice> --no-fonts --codeagent <choice>\n'
+      );
+      process.exit(1);
+    }
+  }
+
   p.intro('Create a new project using Archetype AI Design System.');
 
   // specify project name
@@ -95,44 +125,87 @@ export async function create(args) {
     process.exit(1);
   }
 
-  // specify framework
-  let framework = flags.framework;
-  if (!framework) {
-    if (!interactive) {
-      framework = DEFAULTS.framework;
-    } else {
-      framework = await p.select({
-        message: 'Which framework?',
-        options: [{ value: 'svelte', label: 'SvelteKit', hint: 'Svelte 5 + Tailwind v4, default' }]
-      });
-      if (p.isCancel(framework)) {
-        p.cancel('Setup cancelled.');
-        process.exit(0);
-      }
+  // specify framework (only svelte supported, default silently)
+  let framework = flags.framework || 'svelte';
+  if (!flags.framework && interactive) {
+    framework = await p.select({
+      message: 'Which framework?',
+      options: [{ value: 'svelte', label: 'SvelteKit', hint: 'Svelte 5 + Tailwind v4, default' }]
+    });
+    if (p.isCancel(framework)) {
+      p.cancel('Setup cancelled.');
+      process.exit(0);
     }
   }
 
   // specify package manager
   let pmName = flags.pm;
   if (!pmName) {
-    if (!interactive) {
-      pmName = DEFAULTS.pm;
+    pmName = await p.select({
+      message: 'Which package manager?',
+      options: pmNames.map((n) => ({
+        value: n,
+        label: n,
+        ...(n === DEFAULTS.pm && { hint: 'default' })
+      }))
+    });
+    if (p.isCancel(pmName)) {
+      p.cancel('Setup cancelled.');
+      process.exit(0);
+    }
+  }
+  const pm = getPm(pmName);
+
+  // specify fonts
+  let fontsPath = null;
+  let includeFonts = false;
+  if (flags.fonts === false) {
+    // --no-fonts: skip
+  } else if (typeof flags.fonts === 'string') {
+    fontsPath = flags.fonts;
+    const result = validateFontsPath(fontsPath);
+    if (!result.valid) {
+      if (!interactive) {
+        p.log.error(result.error);
+        process.exit(1);
+      }
+      p.log.warn(result.error);
+      p.log.warn('Continuing without fonts.');
+      fontsPath = null;
     } else {
-      pmName = await p.select({
-        message: 'Which package manager?',
-        options: pmNames.map((n) => ({
-          value: n,
-          label: n,
-          ...(n === DEFAULTS.pm && { hint: 'default' })
-        }))
+      includeFonts = true;
+    }
+  } else {
+    const useFonts = await p.confirm({
+      message: 'Do you want to use internal fonts?',
+      initialValue: false
+    });
+    if (p.isCancel(useFonts)) {
+      p.cancel('Setup cancelled.');
+      process.exit(0);
+    }
+    if (useFonts) {
+      const fontInput = await p.text({
+        message: 'Drop your fonts folder here:',
+        placeholder: '/path/to/fonts'
       });
-      if (p.isCancel(pmName)) {
+      if (p.isCancel(fontInput)) {
         p.cancel('Setup cancelled.');
         process.exit(0);
       }
+      if (fontInput && fontInput.trim()) {
+        fontsPath = fontInput.trim();
+        const result = validateFontsPath(fontsPath);
+        if (!result.valid) {
+          p.log.warn(result.error);
+          p.log.warn('Continuing without fonts.');
+          fontsPath = null;
+        } else {
+          includeFonts = true;
+        }
+      }
     }
   }
-  const pm = getPm(pmName);
 
   // verify package manager is installed
   if (!isPmInstalled(pmName)) {
@@ -177,8 +250,22 @@ export async function create(args) {
   // init shadcn-svelte
   await initShadcn(pm, projectPath);
 
+  // install local fonts
+  if (includeFonts && fontsPath) {
+    const s = p.spinner();
+    s.start('Installing fonts');
+    const fontResult = installLocalFonts(fontsPath, projectPath);
+    if (fontResult.success) {
+      s.stop(`${fontResult.fileCount} font files installed`);
+    } else {
+      s.stop('Failed to install fonts');
+      p.log.warn(fontResult.error);
+      p.log.warn('Continuing without fonts.');
+      includeFonts = false;
+    }
+  }
+
   // configure CSS
-  const includeFonts = false;
   configureCss(projectPath, includeFonts);
 
   // set up linting and formatting
@@ -202,33 +289,20 @@ export async function create(args) {
   // specify agent config
   let agent = flags.agent;
   if (!agent) {
-    if (!interactive) {
-      agent = DEFAULTS.agent;
-    } else {
-      agent = await p.select({
-        message: 'Install AI agent configuration?',
-        options: [
-          { value: 'none', label: 'None' },
-          { value: 'cursor', label: 'Cursor', hint: 'AGENTS.md + skills + rules' },
-          { value: 'claude', label: 'Claude Code', hint: 'CLAUDE.md + skills + rules, default' }
-        ]
-      });
-      if (p.isCancel(agent)) {
-        p.cancel('Setup cancelled.');
-        process.exit(0);
-      }
+    agent = await p.select({
+      message: 'Install AI agent configuration?',
+      options: [
+        { value: 'none', label: 'None' },
+        { value: 'cursor', label: 'Cursor', hint: 'AGENTS.md + skills + rules' },
+        { value: 'claude', label: 'Claude Code', hint: 'CLAUDE.md + skills + rules, default' }
+      ]
+    });
+    if (p.isCancel(agent)) {
+      p.cancel('Setup cancelled.');
+      process.exit(0);
     }
   }
 
-  // log defaults notice
-  if (!interactive) {
-    const applied = {};
-    if (!flags.framework) applied.framework = framework;
-    if (!flags.pm) applied.pm = pmName;
-    if (!flags.agent) applied.codeagent = agent;
-    logDefaultsNotice(applied);
-  }
-
   const validAgents = ['cursor', 'claude', 'none'];
   if (!validAgents.includes(agent)) {
     p.log.error(`Invalid --codeagent value "${agent}". Must be one of: ${validAgents.join(', ')}`);

package/commands/init.js

@@ -13,12 +13,14 @@ import {
   installComponents,
   installAgentConfig
 } from '../lib/scaffold-ds-svelte-project.js';
-import { isInteractive, DEFAULTS, logDefaultsNotice } from '../lib/is-interactive.js';
+import { validateFontsPath, installLocalFonts } from '../lib/install-fonts-local.js';
+import { isInteractive, DEFAULTS } from '../lib/is-interactive.js';
 
 // parse flags
 export function parseFlags(args) {
   const flags = {
     pm: null,
+    fonts: null,
     components: true,
     agent: null,
     defaults: false
@@ -28,6 +30,10 @@ export function parseFlags(args) {
     const arg = args[i];
     if (arg === '--pm' && args[i + 1]) {
       flags.pm = args[++i];
+    } else if (arg === '--fonts' && args[i + 1]) {
+      flags.fonts = args[++i];
+    } else if (arg === '--no-fonts') {
+      flags.fonts = false;
     } else if (arg === '--no-components') {
       flags.components = false;
     } else if (arg === '--codeagent' && args[i + 1]) {
@@ -57,6 +63,29 @@ export async function init(args) {
   const interactive = isInteractive(flags);
   const projectPath = process.cwd();
 
+  // preflight: in non-interactive mode, list all unspecified options and exit
+  if (!interactive) {
+    const missing = [];
+    if (!flags.pm && !detectPm(projectPath))
+      missing.push('  --pm <npm (default)|pnpm|bun|yarn> Package manager');
+    if (flags.fonts === null)
+      missing.push('  --fonts <path> | --no-fonts        Internal fonts (PP Neue Montreal)');
+    if (!flags.agent) missing.push('  --codeagent <cursor|claude|none>   AI agent configuration');
+
+    if (missing.length > 0) {
+      console.log(
+        '[CONFIGURATION REQUIRED] Do not assume defaults. Ask the user to choose each option:\n\n' +
+          missing.join('\n') +
+          '\n\nOptional:\n' +
+          '  --no-components                    Skip component installation\n\n' +
+          'Once the user has answered, re-run with their choices:\n' +
+          '  ds init --pm <choice> --fonts <path> --codeagent <choice>\n' +
+          '  ds init --pm <choice> --no-fonts --codeagent <choice>\n'
+      );
+      process.exit(1);
+    }
+  }
+
   // validate --pm flag
   if (flags.pm && !pmNames.includes(flags.pm)) {
     p.log.error(`Invalid --pm value "${flags.pm}". Must be one of: ${pmNames.join(', ')}`);
@@ -91,32 +120,71 @@ export async function init(args) {
     }
   }
   if (!pmName) {
-    if (!interactive) {
-      pmName = DEFAULTS.pm;
+    pmName = await p.select({
+      message: 'Which package manager?',
+      options: pmNames.map((n) => ({
+        value: n,
+        label: n,
+        ...(n === DEFAULTS.pm && { hint: 'default' })
+      }))
+    });
+    if (p.isCancel(pmName)) {
+      p.cancel('Setup cancelled.');
+      process.exit(0);
+    }
+  }
+  const pm = getPm(pmName);
+
+  // specify fonts
+  let fontsPath = null;
+  let includeFonts = false;
+  if (flags.fonts === false) {
+    // --no-fonts: skip
+  } else if (typeof flags.fonts === 'string') {
+    fontsPath = flags.fonts;
+    const result = validateFontsPath(fontsPath);
+    if (!result.valid) {
+      if (!interactive) {
+        p.log.error(result.error);
+        process.exit(1);
+      }
+      p.log.warn(result.error);
+      p.log.warn('Continuing without fonts.');
+      fontsPath = null;
     } else {
-      pmName = await p.select({
-        message: 'Which package manager?',
-        options: pmNames.map((n) => ({
-          value: n,
-          label: n,
-          ...(n === DEFAULTS.pm && { hint: 'default' })
-        }))
+      includeFonts = true;
+    }
+  } else {
+    const useFonts = await p.confirm({
+      message: 'Do you want to use internal fonts?',
+      initialValue: false
+    });
+    if (p.isCancel(useFonts)) {
+      p.cancel('Setup cancelled.');
+      process.exit(0);
+    }
+    if (useFonts) {
+      const fontInput = await p.text({
+        message: 'Drop your fonts folder here:',
+        placeholder: '/path/to/fonts'
       });
-      if (p.isCancel(pmName)) {
+      if (p.isCancel(fontInput)) {
         p.cancel('Setup cancelled.');
         process.exit(0);
       }
+      if (fontInput && fontInput.trim()) {
+        fontsPath = fontInput.trim();
+        const result = validateFontsPath(fontsPath);
+        if (!result.valid) {
+          p.log.warn(result.error);
+          p.log.warn('Continuing without fonts.');
+          fontsPath = null;
+        } else {
+          includeFonts = true;
+        }
+      }
     }
   }
-  const pm = getPm(pmName);
-
-  // log defaults notice
-  if (!interactive) {
-    const applied = {};
-    if (!flags.pm) applied.pm = pmName;
-    if (!flags.agent) applied.codeagent = DEFAULTS.agent;
-    logDefaultsNotice(applied);
-  }
 
   // verify package manager is installed
   if (!isPmInstalled(pmName)) {
@@ -142,8 +210,22 @@ export async function init(args) {
   // init shadcn-svelte
   await initShadcn(pm, projectPath);
 
+  // install local fonts
+  if (includeFonts && fontsPath) {
+    const s = p.spinner();
+    s.start('Installing fonts');
+    const fontResult = installLocalFonts(fontsPath, projectPath);
+    if (fontResult.success) {
+      s.stop(`${fontResult.fileCount} font files installed`);
+    } else {
+      s.stop('Failed to install fonts');
+      p.log.warn(fontResult.error);
+      p.log.warn('Continuing without fonts.');
+      includeFonts = false;
+    }
+  }
+
   // configure CSS (prepend to existing)
-  const includeFonts = false;
   prependCss(projectPath, includeFonts);
 
   // set up linting and formatting
@@ -167,21 +249,17 @@ export async function init(args) {
   // specify agent config
   let agent = flags.agent;
   if (!agent) {
-    if (!interactive) {
-      agent = DEFAULTS.agent;
-    } else {
-      agent = await p.select({
-        message: 'Install AI agent configuration?',
-        options: [
-          { value: 'none', label: 'None' },
-          { value: 'cursor', label: 'Cursor', hint: 'AGENTS.md + skills + rules' },
-          { value: 'claude', label: 'Claude Code', hint: 'CLAUDE.md + skills + rules, default' }
-        ]
-      });
-      if (p.isCancel(agent)) {
-        p.cancel('Setup cancelled.');
-        process.exit(0);
-      }
+    agent = await p.select({
+      message: 'Install AI agent configuration?',
+      options: [
+        { value: 'none', label: 'None' },
+        { value: 'cursor', label: 'Cursor', hint: 'AGENTS.md + skills + rules' },
+        { value: 'claude', label: 'Claude Code', hint: 'CLAUDE.md + skills + rules, default' }
+      ]
+    });
+    if (p.isCancel(agent)) {
+      p.cancel('Setup cancelled.');
+      process.exit(0);
     }
   }
 

package/files/AGENTS.md

@@ -49,7 +49,9 @@ Standard Tailwind is fine for:
 Before building a new component, fetch the pattern catalog from:
 `https://design-system.archetypeai.workers.dev/r/patterns.json`
 
-Each entry includes a `name`, `title`, `description`, and `registryDependencies`. Reuse or extend existing patterns instead of rebuilding from scratch. To install a pattern:
+Each entry includes a `name`, `title`, `description`, and `registryDependencies`. Reuse or extend existing patterns instead of rebuilding from scratch.
+
+Before installing, check if the pattern already exists locally in `$lib/components/ui/patterns/{name}/`. Only install if it is missing:
 `npx shadcn-svelte@latest add https://design-system.archetypeai.workers.dev/r/{name}.json`
 
 ## Skills

package/files/CLAUDE.md

@@ -49,7 +49,9 @@ Standard Tailwind is fine for:
 Before building a new component, fetch the pattern catalog from:
 `https://design-system.archetypeai.workers.dev/r/patterns.json`
 
-Each entry includes a `name`, `title`, `description`, and `registryDependencies`. Reuse or extend existing patterns instead of rebuilding from scratch. To install a pattern:
+Each entry includes a `name`, `title`, `description`, and `registryDependencies`. Reuse or extend existing patterns instead of rebuilding from scratch.
+
+Before installing, check if the pattern already exists locally in `$lib/components/ui/patterns/{name}/`. Only install if it is missing:
 `npx shadcn-svelte@latest add https://design-system.archetypeai.workers.dev/r/{name}.json`
 
 ## Skills

package/files/rules/frontend-architecture.md

@@ -31,6 +31,17 @@ The project includes pattern components that demonstrate these conventions. Stud
 
 Check if an existing pattern fits before building a new one. Use `@skills/build-pattern` to create new patterns that follow these same conventions.
 
+## Directory structure
+
+```
+$lib/components/ui/
+  primitives/   — DS registry primitives (Card, Badge, Button, etc.)
+  patterns/     — DS registry patterns (BackgroundCard, FlatLogItem, etc.)
+  custom/       — Project-specific components not from the registry
+```
+
+Place custom components (ones you create for this project that are not installed from the registry) in `$lib/components/ui/custom/`. Never put custom components directly in `ui/` next to `primitives/` and `patterns/`.
+
 ## Component conventions
 
 Follow `@rules/components` for the full conventions. The essentials:

package/files/rules/styling.md

@@ -90,6 +90,16 @@ In your global CSS file:
 
 Order matters - tokens must come before Tailwind.
 
+### Hide Scrollbars
+
+Always add this rule to the root layout CSS (`src/app.css` or `src/routes/layout.css`) to hide visible scrollbars in ScrollArea components:
+
+```css
+[data-slot='scroll-area-scrollbar'] {
+	display: none !important;
+}
+```
+
 ## Tailwind v4 Specifics
 
 ### @theme Directive

package/files/skills/create-dashboard/SKILL.md

@@ -33,7 +33,7 @@ Dashboards fill the entire viewport with no scrolling:
 Unless the user explicitly asks for a different layout:
 
 - **Equal-width columns** — use `grid-cols-2`, `grid-cols-3`, etc. Never mix fixed and fluid widths for card grids (e.g., don't use `grid-cols-[300px_1fr]` for cards — that's for sidebar layouts only)
-- **Equal-height cards** — CSS grid rows distribute height evenly. Add `max-h-full` to each Card so content stays constrained to its grid cell
+- **Cards fill available height** — cards must stretch to fill their grid cell or flex container. Add `max-h-full` to constrain content. For asymmetric layouts (stacked cards in one column, full-height card in another), use a flex column with `flex-1` on the card that should grow
 - **Consistent spacing** — always use `gap-4` between cards and `p-4` padding around the grid
 
 ## Menubar
@@ -123,7 +123,7 @@ For co-branding, pass a `partnerLogo` snippet to replace the default placeholder
 </main>
 ```
 
-### Grid of Cards
+### Grid of Cards (Equal)
 
 ```svelte
 <main class="grid grid-cols-2 grid-rows-2 gap-4 overflow-hidden p-4">
@@ -134,6 +134,25 @@ For co-branding, pass a `partnerLogo` snippet to replace the default placeholder
 </main>
 ```
 
+### Asymmetric Cards (Stacked Left + Full-Height Right)
+
+When one column has multiple cards and the other has a single tall card, use `grid-rows-subgrid` or nested flex columns. Cards must stretch to fill available height — never leave empty space at the bottom.
+
+```svelte
+<main class="grid grid-cols-[1fr_2fr] gap-4 overflow-hidden p-4">
+  <!-- Left column: stacked cards that fill height -->
+  <div class="flex flex-col gap-4 overflow-hidden">
+    <Card class="max-h-full"><!-- input --></Card>
+    <Card class="max-h-full"><!-- status --></Card>
+    <Card class="max-h-full flex-1"><!-- summary (grows to fill remaining space) --></Card>
+  </div>
+  <!-- Right column: single card spanning full height -->
+  <Card class="max-h-full overflow-hidden"><!-- log / results --></Card>
+</main>
+```
+
+The `flex-1` on the last left-column card makes it grow to fill remaining vertical space. Adjust column ratio (`1fr_2fr`, `1fr_1fr`, etc.) to match content needs.
+
 ## Key Tailwind Classes
 
 | Class                    | Purpose                                      |

package/lib/install-fonts-local.js

@@ -0,0 +1,212 @@
+import { existsSync, readdirSync, copyFileSync, mkdirSync, writeFileSync } from 'fs';
+import { join, resolve } from 'path';
+
+// all 15 required font files
+export const REQUIRED_FONTS = [
+  // PP Neue Montreal Sans (.ttf)
+  'PPNeueMontreal-Thin.ttf',
+  'PPNeueMontreal-ThinItalic.ttf',
+  'PPNeueMontreal-Light.ttf',
+  'PPNeueMontreal-Regular.ttf',
+  'PPNeueMontreal-Italic.ttf',
+  'PPNeueMontreal-Book.ttf',
+  'PPNeueMontreal-Medium.ttf',
+  'PPNeueMontreal-Bold.ttf',
+  'PPNeueMontreal-BoldItalic.ttf',
+  // PP Neue Montreal Mono (.otf)
+  'PPNeueMontrealMono-Thin.otf',
+  'PPNeueMontrealMono-Regular.otf',
+  'PPNeueMontrealMono-RegularItalic.otf',
+  'PPNeueMontrealMono-Book.otf',
+  'PPNeueMontrealMono-Medium.otf',
+  'PPNeueMontrealMono-Bold.otf'
+];
+
+// hardcoded fonts.css template
+export const FONTS_CSS = `/* PP Neue Montreal Sans*/
+
+@font-face {
+  font-family: 'PP Neue Montreal';
+  src: url('/fonts/PPNeueMontreal-Thin.ttf') format('truetype');
+  font-weight: 100;
+  font-style: normal;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'PP Neue Montreal';
+  src: url('/fonts/PPNeueMontreal-ThinItalic.ttf') format('truetype');
+  font-weight: 100;
+  font-style: italic;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'PP Neue Montreal';
+  src: url('/fonts/PPNeueMontreal-Light.ttf') format('truetype');
+  font-weight: 300;
+  font-style: normal;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'PP Neue Montreal';
+  src: url('/fonts/PPNeueMontreal-Regular.ttf') format('truetype');
+  font-weight: 400;
+  font-style: normal;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'PP Neue Montreal';
+  src: url('/fonts/PPNeueMontreal-Italic.ttf') format('truetype');
+  font-weight: 400;
+  font-style: italic;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'PP Neue Montreal';
+  src: url('/fonts/PPNeueMontreal-Book.ttf') format('truetype');
+  font-weight: 400;
+  font-style: normal;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'PP Neue Montreal';
+  src: url('/fonts/PPNeueMontreal-Medium.ttf') format('truetype');
+  font-weight: 500;
+  font-style: normal;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'PP Neue Montreal';
+  src: url('/fonts/PPNeueMontreal-Bold.ttf') format('truetype');
+  font-weight: 700;
+  font-style: normal;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'PP Neue Montreal';
+  src: url('/fonts/PPNeueMontreal-BoldItalic.ttf') format('truetype');
+  font-weight: 700;
+  font-style: italic;
+  font-display: swap;
+}
+
+/* PP Neue Montreal Mono */
+
+@font-face {
+  font-family: 'PP Neue Montreal Mono';
+  src: url('/fonts/PPNeueMontrealMono-Thin.otf') format('opentype');
+  font-weight: 100;
+  font-style: normal;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'PP Neue Montreal Mono';
+  src: url('/fonts/PPNeueMontrealMono-Regular.otf') format('opentype');
+  font-weight: 400;
+  font-style: normal;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'PP Neue Montreal Mono';
+  src: url('/fonts/PPNeueMontrealMono-RegularItalic.otf') format('opentype');
+  font-weight: 400;
+  font-style: italic;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'PP Neue Montreal Mono';
+  src: url('/fonts/PPNeueMontrealMono-Book.otf') format('opentype');
+  font-weight: 400;
+  font-style: normal;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'PP Neue Montreal Mono';
+  src: url('/fonts/PPNeueMontrealMono-Medium.otf') format('opentype');
+  font-weight: 500;
+  font-style: normal;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'PP Neue Montreal Mono';
+  src: url('/fonts/PPNeueMontrealMono-Bold.otf') format('opentype');
+  font-weight: 700;
+  font-style: normal;
+  font-display: swap;
+}
+`;
+
+// validate that a directory contains all required font files
+export function validateFontsPath(fontsPath) {
+  const resolved = resolve(fontsPath);
+
+  if (!existsSync(resolved)) {
+    return { valid: false, missing: REQUIRED_FONTS, error: `Path does not exist: ${resolved}` };
+  }
+
+  let entries;
+  try {
+    entries = readdirSync(resolved);
+  } catch {
+    return { valid: false, missing: REQUIRED_FONTS, error: `Cannot read directory: ${resolved}` };
+  }
+
+  const missing = REQUIRED_FONTS.filter((f) => !entries.includes(f));
+  if (missing.length > 0) {
+    return {
+      valid: false,
+      missing,
+      error: `Missing ${missing.length} font file(s): ${missing.join(', ')}`
+    };
+  }
+
+  return { valid: true, missing: [] };
+}
+
+// copy required font files to <project>/static/fonts/
+export function copyFontsToStatic(fontsPath, projectPath) {
+  const src = resolve(fontsPath);
+  const dest = join(projectPath, 'static', 'fonts');
+  mkdirSync(dest, { recursive: true });
+
+  for (const file of REQUIRED_FONTS) {
+    copyFileSync(join(src, file), join(dest, file));
+  }
+
+  return REQUIRED_FONTS.length;
+}
+
+// write fonts.css to src/routes/fonts.css
+function writeFontsCss(projectPath) {
+  const cssPath = join(projectPath, 'src', 'routes', 'fonts.css');
+  const dir = join(projectPath, 'src', 'routes');
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  writeFileSync(cssPath, FONTS_CSS);
+}
+
+// orchestrate: validate, copy fonts, write fonts.css
+export function installLocalFonts(fontsPath, projectPath) {
+  const validation = validateFontsPath(fontsPath);
+  if (!validation.valid) {
+    return { success: false, fileCount: 0, error: validation.error };
+  }
+
+  const fileCount = copyFontsToStatic(fontsPath, projectPath);
+  writeFontsCss(projectPath);
+
+  return { success: true, fileCount };
+}

package/lib/is-interactive.js

@@ -1,5 +1,3 @@
-import * as p from '@clack/prompts';
-
 export const DEFAULTS = {
   framework: 'svelte',
   pm: 'npm',
@@ -10,10 +8,3 @@ export function isInteractive(flags) {
   if (flags.defaults) return false;
   return !!process.stdin.isTTY;
 }
-
-export function logDefaultsNotice(applied) {
-  const parts = Object.entries(applied).map(([k, v]) => `${k}=${v}`);
-  if (parts.length > 0) {
-    p.log.info(`Non-interactive mode: using defaults (${parts.join(', ')})`);
-  }
-}

package/lib/scaffold-ds-svelte-project.js

@@ -88,23 +88,6 @@ export async function installTokens(pm, projectPath) {
   }
 }
 
-// install internal fonts package
-export async function installFonts(pm, projectPath) {
-  const [cmd, ...baseArgs] = splitCmd(pm.install);
-  const args = [...baseArgs, '@archetypeai/ds-lib-fonts-internal'];
-  const s = p.spinner();
-  s.start('Installing internal fonts');
-  try {
-    await run(cmd, args, { cwd: projectPath });
-    s.stop('Internal fonts installed');
-    return true;
-  } catch {
-    s.stop('Failed to install internal fonts');
-    p.log.warn('Make sure you are authenticated with npm (run: npm login)');
-    return false;
-  }
-}
-
 // init shadcn-svelte
 export async function initShadcn(pm, projectPath) {
   const s = p.spinner();
@@ -166,7 +149,7 @@ export function cn(...inputs) {
 export function configureCss(projectPath, includeFonts) {
   let css = '';
   if (includeFonts) {
-    css += '@import "@archetypeai/ds-lib-fonts-internal";\n';
+    css += '@import "./fonts.css";\n';
   }
   css += '@import "@archetypeai/ds-lib-tokens/theme.css";\n';
   css += '@import "tailwindcss";\n';
@@ -211,7 +194,7 @@ export function prependCss(projectPath, includeFonts) {
 
   let imports = '';
   if (includeFonts) {
-    imports += '@import "@archetypeai/ds-lib-fonts-internal";\n';
+    imports += '@import "./fonts.css";\n';
   }
   imports += '@import "@archetypeai/ds-lib-tokens/theme.css";\n';
   imports += '@import "tailwindcss";\n';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archetypeai/ds-cli",
-  "version": "0.3.17",
+  "version": "0.3.18",
   "description": "Archetype AI Design System CLI Tool",
   "type": "module",
   "bin": {