Function scaffoldProject

packages/cli/src/commands/init.ts:518–577

(
  destDir: string,
  name: string,
  templateId: string,
  localVideoName: string | undefined,
  durationSeconds?: number,
  tailwind = false,
  resolution?: CanvasResolution,
)

// ---------------------------------------------------------------------------

async function scaffoldProject(
  destDir: string,
  name: string,
  templateId: string,
  localVideoName: string | undefined,
  durationSeconds?: number,
  tailwind = false,
  resolution?: CanvasResolution,
): Promise<void> {
  mkdirSync(destDir, { recursive: true });

  // Use bundled template if available, otherwise fetch from GitHub.
  // Check for index.html inside the dir — an empty directory left by the
  // build toolchain should not prevent the remote fetch fallback.
  const templateDir = getStaticTemplateDir(templateId);
  if (existsSync(join(templateDir, "index.html"))) {
    cpSync(templateDir, destDir, { recursive: true });
  } else {
    await fetchRemoteTemplate(templateId, destDir);
  }
  patchVideoSrc(destDir, localVideoName, durationSeconds);
  if (tailwind) writeTailwindSupport(destDir);
  if (resolution) applyResolutionPreset(destDir, resolution);

  writeFileSync(
    resolve(destDir, "meta.json"),
    JSON.stringify(
      {
        id: name,
        name,
        createdAt: new Date().toISOString(),
      },
      null,
      2,
    ),
    "utf-8",
  );

  // Write hyperframes.json so `hyperframes add` knows which registry to use
  // and where to drop block/component files. Overwritten only if absent.
  if (!existsSync(resolve(destDir, "hyperframes.json"))) {
    const { writeProjectConfig, DEFAULT_PROJECT_CONFIG } =
      await import("../utils/projectConfig.js");
    writeProjectConfig(destDir, DEFAULT_PROJECT_CONFIG);
  }

  writeDefaultPackageJson(destDir, name);

  // Copy shared files (CLAUDE.md, AGENTS.md) for AI agent context
  const sharedDir = getSharedTemplateDir();
  if (existsSync(sharedDir)) {
    for (const entry of readdirSync(sharedDir, { withFileTypes: true })) {
      const src = join(sharedDir, entry.name);
      const dest = resolve(destDir, entry.name);
      if (entry.isFile() || entry.isSymbolicLink()) {
        copyFileSync(src, dest);
      }
    }