@codecanvascollective/scaffold 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CodeCanvas Collective
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,67 @@
+# scaffold
+
+[![CI](https://github.com/CodeCanvasCollective/scaffold/actions/workflows/ci.yml/badge.svg)](https://github.com/CodeCanvasCollective/scaffold/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@codecanvascollective/scaffold)](https://www.npmjs.com/package/@codecanvascollective/scaffold)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+> Interactive CLI tool for scaffolding modern full-stack projects.
+
+Generate production-ready project structures for React, Next.js, Angular, Express, and FastAPI — with TypeScript, ESLint, Prettier, testing, and CI/CD pre-configured.
+
+## Quick Start
+
+```bash
+npx @codecanvascollective/scaffold create my-app
+```
+
+Or use quick mode to skip prompts:
+
+```bash
+npx @codecanvascollective/scaffold create my-app --react
+npx @codecanvascollective/scaffold create my-app --nextjs
+npx @codecanvascollective/scaffold create my-app --express
+```
+
+## Supported Frameworks
+
+| Framework | Type | Variants |
+|-----------|------|----------|
+| React + Vite | Frontend | Base, Tailwind, shadcn/ui |
+| Next.js (App Router) | Frontend | Base, NextAuth, Prisma |
+| Angular 18 | Frontend | Base |
+| Express.js | Backend | Base, Prisma |
+| FastAPI | Backend | Base |
+
+## Features
+
+- **Interactive prompts** — guided project setup with framework, features, and config selection
+- **Quick mode** — skip prompts with `--react`, `--nextjs`, `--express` flags
+- **Template variants** — choose between base setup and pre-configured add-ons
+- **Feature selection** — ESLint, Prettier, Tailwind, testing, Docker, GitHub Actions, and more
+- **Plugin system** — extend with custom templates and hooks
+- **Multiple package managers** — npm, yarn, or pnpm
+
+## Commands
+
+```bash
+scaffold create <name>          # Interactive project creation
+scaffold create <name> --react  # Quick mode (skip prompts)
+scaffold create <name> -y       # Use all defaults
+scaffold create <name> --from config.json  # From config file
+scaffold list                   # List available templates
+scaffold doctor                 # Check system dependencies
+scaffold --version              # Show version
+scaffold --help                 # Show help
+```
+
+## Contributing
+
+See [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md) for development setup and contribution guidelines.
+
+## Plugin System
+
+Extend scaffold with custom plugins. See [docs/PLUGIN_GUIDE.md](docs/PLUGIN_GUIDE.md).
+
+## License
+
+MIT — [CodeCanvas Collective](https://codecanvascollective.com)

package/dist/chunk-2A65KFCS.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+
+// src/utils/file.ts
+import path from "path";
+import fs from "fs-extra";
+import Handlebars from "handlebars";
+import { fileURLToPath } from "url";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = path.dirname(__filename);
+Handlebars.registerHelper("eq", (a, b) => a === b);
+Handlebars.registerHelper("neq", (a, b) => a !== b);
+Handlebars.registerHelper("or", (a, b) => a || b);
+Handlebars.registerHelper("and", (a, b) => a && b);
+Handlebars.registerHelper("lowercase", (str) => str?.toLowerCase());
+Handlebars.registerHelper("year", () => (/* @__PURE__ */ new Date()).getFullYear());
+Handlebars.registerHelper(
+  "join",
+  (arr, sep) => Array.isArray(arr) ? arr.join(typeof sep === "string" ? sep : ", ") : ""
+);
+function getTemplatesDir() {
+  const isBundled = __dirname.replace(/\\/g, "/").endsWith("/dist") || __dirname.replace(/\\/g, "/").includes("/dist/");
+  const projectRoot = isBundled ? path.resolve(__dirname, "..") : path.resolve(__dirname, "..", "..");
+  return path.resolve(projectRoot, "src", "templates");
+}
+async function createDir(dirPath) {
+  await fs.ensureDir(dirPath);
+}
+async function writeFile(filePath, content) {
+  await fs.ensureDir(path.dirname(filePath));
+  await fs.writeFile(filePath, content, "utf-8");
+}
+async function copyFile(src, dest) {
+  await fs.ensureDir(path.dirname(dest));
+  await fs.copy(src, dest);
+}
+async function renderTemplate(templatePath, data) {
+  const templateContent = await fs.readFile(templatePath, "utf-8");
+  const template = Handlebars.compile(templateContent, { noEscape: true });
+  return template(data);
+}
+async function renderAndWrite(templatePath, outputPath, data) {
+  const content = await renderTemplate(templatePath, data);
+  await writeFile(outputPath, content);
+}
+async function directoryExists(dirPath) {
+  try {
+    const stat = await fs.stat(dirPath);
+    return stat.isDirectory();
+  } catch {
+    return false;
+  }
+}
+async function fileExists(filePath) {
+  try {
+    const stat = await fs.stat(filePath);
+    return stat.isFile();
+  } catch {
+    return false;
+  }
+}
+function getOutputFileName(templateName) {
+  return templateName.replace(/\.hbs$/, "");
+}
+
+export {
+  getTemplatesDir,
+  createDir,
+  writeFile,
+  copyFile,
+  renderTemplate,
+  renderAndWrite,
+  directoryExists,
+  fileExists,
+  getOutputFileName
+};
+//# sourceMappingURL=chunk-2A65KFCS.js.map

package/dist/chunk-2A65KFCS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/file.ts"],"sourcesContent":["import path from 'node:path';\nimport fs from 'fs-extra';\nimport Handlebars from 'handlebars';\nimport { fileURLToPath } from 'node:url';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\n// Register custom Handlebars helpers\nHandlebars.registerHelper('eq', (a: unknown, b: unknown) => a === b);\nHandlebars.registerHelper('neq', (a: unknown, b: unknown) => a !== b);\nHandlebars.registerHelper('or', (a: unknown, b: unknown) => a || b);\nHandlebars.registerHelper('and', (a: unknown, b: unknown) => a && b);\nHandlebars.registerHelper('lowercase', (str: string) => str?.toLowerCase());\nHandlebars.registerHelper('year', () => new Date().getFullYear());\nHandlebars.registerHelper('join', (arr: string[], sep: string) =>\n  Array.isArray(arr) ? arr.join(typeof sep === 'string' ? sep : ', ') : '',\n);\n\nexport function getTemplatesDir(): string {\n  // When bundled with tsup, __dirname is dist/ → go up 1 level to project root\n  // When running unbundled (vitest), __dirname is src/utils/ → go up 2 levels to project root\n  // In both cases, templates live at <projectRoot>/src/templates\n  const isBundled = __dirname.replace(/\\\\/g, '/').endsWith('/dist') ||\n    __dirname.replace(/\\\\/g, '/').includes('/dist/');\n  const projectRoot = isBundled\n    ? path.resolve(__dirname, '..')\n    : path.resolve(__dirname, '..', '..');\n  return path.resolve(projectRoot, 'src', 'templates');\n}\n\nexport async function createDir(dirPath: string): Promise<void> {\n  await fs.ensureDir(dirPath);\n}\n\nexport async function writeFile(filePath: string, content: string): Promise<void> {\n  await fs.ensureDir(path.dirname(filePath));\n  await fs.writeFile(filePath, content, 'utf-8');\n}\n\nexport async function copyFile(src: string, dest: string): Promise<void> {\n  await fs.ensureDir(path.dirname(dest));\n  await fs.copy(src, dest);\n}\n\nexport async function renderTemplate(templatePath: string, data: object): Promise<string> {\n  const templateContent = await fs.readFile(templatePath, 'utf-8');\n  const template = Handlebars.compile(templateContent, { noEscape: true });\n  return template(data);\n}\n\nexport async function renderAndWrite(\n  templatePath: string,\n  outputPath: string,\n  data: object,\n): Promise<void> {\n  const content = await renderTemplate(templatePath, data);\n  await writeFile(outputPath, content);\n}\n\nexport async function directoryExists(dirPath: string): Promise<boolean> {\n  try {\n    const stat = await fs.stat(dirPath);\n    return stat.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nexport async function fileExists(filePath: string): Promise<boolean> {\n  try {\n    const stat = await fs.stat(filePath);\n    return stat.isFile();\n  } catch {\n    return false;\n  }\n}\n\nexport function getOutputFileName(templateName: string): string {\n  return templateName.replace(/\\.hbs$/, '');\n}\n"],"mappings":";;;AAAA,OAAO,UAAU;AACjB,OAAO,QAAQ;AACf,OAAO,gBAAgB;AACvB,SAAS,qBAAqB;AAE9B,IAAM,aAAa,cAAc,YAAY,GAAG;AAChD,IAAM,YAAY,KAAK,QAAQ,UAAU;AAGzC,WAAW,eAAe,MAAM,CAAC,GAAY,MAAe,MAAM,CAAC;AACnE,WAAW,eAAe,OAAO,CAAC,GAAY,MAAe,MAAM,CAAC;AACpE,WAAW,eAAe,MAAM,CAAC,GAAY,MAAe,KAAK,CAAC;AAClE,WAAW,eAAe,OAAO,CAAC,GAAY,MAAe,KAAK,CAAC;AACnE,WAAW,eAAe,aAAa,CAAC,QAAgB,KAAK,YAAY,CAAC;AAC1E,WAAW,eAAe,QAAQ,OAAM,oBAAI,KAAK,GAAE,YAAY,CAAC;AAChE,WAAW;AAAA,EAAe;AAAA,EAAQ,CAAC,KAAe,QAChD,MAAM,QAAQ,GAAG,IAAI,IAAI,KAAK,OAAO,QAAQ,WAAW,MAAM,IAAI,IAAI;AACxE;AAEO,SAAS,kBAA0B;AAIxC,QAAM,YAAY,UAAU,QAAQ,OAAO,GAAG,EAAE,SAAS,OAAO,KAC9D,UAAU,QAAQ,OAAO,GAAG,EAAE,SAAS,QAAQ;AACjD,QAAM,cAAc,YAChB,KAAK,QAAQ,WAAW,IAAI,IAC5B,KAAK,QAAQ,WAAW,MAAM,IAAI;AACtC,SAAO,KAAK,QAAQ,aAAa,OAAO,WAAW;AACrD;AAEA,eAAsB,UAAU,SAAgC;AAC9D,QAAM,GAAG,UAAU,OAAO;AAC5B;AAEA,eAAsB,UAAU,UAAkB,SAAgC;AAChF,QAAM,GAAG,UAAU,KAAK,QAAQ,QAAQ,CAAC;AACzC,QAAM,GAAG,UAAU,UAAU,SAAS,OAAO;AAC/C;AAEA,eAAsB,SAAS,KAAa,MAA6B;AACvE,QAAM,GAAG,UAAU,KAAK,QAAQ,IAAI,CAAC;AACrC,QAAM,GAAG,KAAK,KAAK,IAAI;AACzB;AAEA,eAAsB,eAAe,cAAsB,MAA+B;AACxF,QAAM,kBAAkB,MAAM,GAAG,SAAS,cAAc,OAAO;AAC/D,QAAM,WAAW,WAAW,QAAQ,iBAAiB,EAAE,UAAU,KAAK,CAAC;AACvE,SAAO,SAAS,IAAI;AACtB;AAEA,eAAsB,eACpB,cACA,YACA,MACe;AACf,QAAM,UAAU,MAAM,eAAe,cAAc,IAAI;AACvD,QAAM,UAAU,YAAY,OAAO;AACrC;AAEA,eAAsB,gBAAgB,SAAmC;AACvE,MAAI;AACF,UAAM,OAAO,MAAM,GAAG,KAAK,OAAO;AAClC,WAAO,KAAK,YAAY;AAAA,EAC1B,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,eAAsB,WAAW,UAAoC;AACnE,MAAI;AACF,UAAM,OAAO,MAAM,GAAG,KAAK,QAAQ;AACnC,WAAO,KAAK,OAAO;AAAA,EACrB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,kBAAkB,cAA8B;AAC9D,SAAO,aAAa,QAAQ,UAAU,EAAE;AAC1C;","names":[]}

package/dist/file-5IKT7CEX.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import {
+  copyFile,
+  createDir,
+  directoryExists,
+  fileExists,
+  getOutputFileName,
+  getTemplatesDir,
+  renderAndWrite,
+  renderTemplate,
+  writeFile
+} from "./chunk-2A65KFCS.js";
+export {
+  copyFile,
+  createDir,
+  directoryExists,
+  fileExists,
+  getOutputFileName,
+  getTemplatesDir,
+  renderAndWrite,
+  renderTemplate,
+  writeFile
+};
+//# sourceMappingURL=file-5IKT7CEX.js.map

package/dist/file-5IKT7CEX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }