create-bodhi-js 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BodhiSearch
+
+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,143 @@
+# create-bodhi-js
+
+Scaffold Bodhi-powered applications with React, TypeScript, Vite, Tailwind CSS, shadcn/ui, and comprehensive tooling.
+
+## Usage
+
+```bash
+# Interactive mode
+npm create bodhi-js@latest
+
+# With project name
+npm create bodhi-js@latest my-app
+
+# With options
+npm create bodhi-js@latest my-app -- --template react --github-pages
+```
+
+## Features
+
+**Core Stack**:
+- ⚡ [Vite 7](https://vite.dev/) - Next generation frontend tooling
+- ⚛️ [React 19](https://react.dev/) - Latest React with modern patterns
+- 📘 [TypeScript](https://www.typescriptlang.org/) - Strict mode enabled
+- 🎨 [Tailwind CSS v4](https://tailwindcss.com/) - Utility-first CSS
+- 🧩 [shadcn/ui](https://ui.shadcn.com/) - Re-usable components
+- 🤖 [bodhi-js-react](https://github.com/BodhiSearch/bodhi-browser) - Local LLM integration
+
+**Code Quality**:
+- 🔍 ESLint 9 + Prettier
+- 📝 EditorConfig
+- 🎯 Strict TypeScript
+
+**Testing**:
+- ✅ [Vitest](https://vitest.dev/) - Unit testing
+- 🎭 [Playwright](https://playwright.dev/) - E2E testing
+
+**CI/CD** (optional):
+- 🔄 GitHub Actions
+- 📦 GitHub Pages deployment
+- 🤖 Dependabot
+
+## Options
+
+```
+Usage: create-bodhi-js [project-name] [options]
+
+Arguments:
+  project-name              Name of the project
+
+Options:
+  -V, --version             output the version number
+  -t, --template <name>     Template to use (react, svelte, vue) (default: "react")
+  --no-install              Skip dependency installation
+  --no-git                  Skip git initialization
+  --github-pages            Enable GitHub Pages deployment setup
+  -h, --help                display help for command
+```
+
+## Templates
+
+### Available Templates
+
+- **react** - React + TypeScript + Vite + Tailwind + shadcn/ui + bodhi-js-react (default)
+
+### Custom Templates
+
+Use any Git repository as a template:
+
+```bash
+npm create bodhi-js@latest my-app -- --template gh:username/my-template
+```
+
+Supported Git providers (via [giget](https://github.com/unjs/giget)):
+- GitHub: `gh:user/repo`
+- GitLab: `gitlab:user/repo`
+- BitBucket: `bitbucket:user/repo`
+
+## What's Included?
+
+When you scaffold a project with `create-bodhi-js`, you get:
+
+```
+my-app/
+├── .github/              # GitHub templates and workflows
+│   ├── workflows/        # CI/CD pipelines
+│   ├── ISSUE_TEMPLATE/   # Issue templates
+│   └── ...
+├── e2e/                  # Playwright E2E tests
+├── public/               # Static assets
+├── src/
+│   ├── components/       # React components
+│   │   └── ui/           # shadcn/ui components
+│   ├── hooks/            # Custom React hooks
+│   ├── lib/              # Utility functions
+│   ├── test/             # Test setup
+│   ├── App.tsx           # Main app component
+│   ├── main.tsx          # Entry point
+│   ├── env.ts            # Environment variable validation
+│   └── index.css         # Global styles
+├── .editorconfig         # Editor configuration
+├── .prettierrc           # Prettier configuration
+├── components.json       # shadcn/ui configuration
+├── eslint.config.js      # ESLint configuration
+├── playwright.config.ts  # Playwright configuration
+├── tsconfig.json         # TypeScript configuration
+├── vite.config.ts        # Vite configuration
+└── package.json          # Dependencies and scripts
+```
+
+## Post-Installation
+
+After scaffolding your project:
+
+1. **Configure environment variables**:
+   ```bash
+   cp .env.example .env
+   # Edit .env with your Bodhi OAuth credentials
+   ```
+
+2. **Start development server**:
+   ```bash
+   npm run dev
+   ```
+
+3. **Run tests**:
+   ```bash
+   npm test           # Unit tests
+   npm run test:e2e   # E2E tests
+   ```
+
+4. **Build for production**:
+   ```bash
+   npm run build
+   ```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Related
+
+- [bodhi-browser](https://github.com/BodhiSearch/bodhi-browser) - Bodhi Browser Extension
+- [template-bodhi-react-vite](https://github.com/BodhiSearch/template-bodhi-react-vite) - React template source

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,242 @@
+#!/usr/bin/env node
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+
+// src/cli.ts
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+
+// src/scaffold.ts
+import { downloadTemplate } from "giget";
+import { promises as fs2 } from "fs";
+import path2 from "path";
+
+// src/processor.ts
+import Handlebars from "handlebars";
+import { promises as fs } from "fs";
+import path from "path";
+var TEMPLATE_FILES = [
+  "package.json",
+  "vite.config.ts",
+  "index.html",
+  "public/404.html",
+  "README.md",
+  "playwright.config.ts"
+];
+async function processTemplates(targetDir, vars) {
+  for (const file of TEMPLATE_FILES) {
+    const filePath = path.join(targetDir, file);
+    try {
+      const content = await fs.readFile(filePath, "utf-8");
+      const template = Handlebars.compile(content);
+      const rendered = template(vars);
+      await fs.writeFile(filePath, rendered, "utf-8");
+    } catch {
+    }
+  }
+}
+
+// src/scaffold.ts
+import { exec } from "child_process";
+import { promisify } from "util";
+var execAsync = promisify(exec);
+async function scaffold(options) {
+  const {
+    projectName,
+    templateUrl,
+    githubOrg,
+    githubPages,
+    basePath,
+    pathSegmentsToKeep,
+    install,
+    git
+  } = options;
+  const targetDir = path2.resolve(process.cwd(), projectName);
+  try {
+    await fs2.access(targetDir);
+    throw new Error(`Directory ${projectName} already exists`);
+  } catch (err) {
+    if (err.code !== "ENOENT") {
+      throw err;
+    }
+  }
+  await downloadTemplate(templateUrl, {
+    dir: targetDir,
+    offline: false
+  });
+  const templateSubdir = path2.join(targetDir, "template");
+  try {
+    await fs2.access(templateSubdir);
+    const files = await fs2.readdir(templateSubdir);
+    for (const file of files) {
+      await fs2.rename(path2.join(templateSubdir, file), path2.join(targetDir, file));
+    }
+    await fs2.rmdir(templateSubdir);
+  } catch {
+  }
+  const dotfiles = ["_gitignore", "_editorconfig", "_prettierrc", "_prettierignore"];
+  for (const file of dotfiles) {
+    const oldPath = path2.join(targetDir, file);
+    const newPath = path2.join(targetDir, file.replace("_", "."));
+    try {
+      await fs2.rename(oldPath, newPath);
+    } catch {
+    }
+  }
+  await processTemplates(targetDir, {
+    projectName,
+    githubOrg,
+    githubPages,
+    basePath,
+    pathSegmentsToKeep
+  });
+  if (!githubPages) {
+    const filesToDelete = [
+      path2.join(targetDir, ".github/workflows/deploy-pages.yml"),
+      path2.join(targetDir, "public/404.html")
+    ];
+    for (const file of filesToDelete) {
+      try {
+        await fs2.unlink(file);
+      } catch {
+      }
+    }
+  }
+  const metaFiles = ["template.json", "test-template.sh", "TECH.md"];
+  for (const file of metaFiles) {
+    try {
+      await fs2.unlink(path2.join(targetDir, file));
+    } catch {
+    }
+  }
+  if (git) {
+    try {
+      await execAsync("git init", { cwd: targetDir });
+      await execAsync("git add .", { cwd: targetDir });
+      await execAsync('git commit -m "chore: initial commit from create-bodhi-js"', {
+        cwd: targetDir
+      });
+    } catch {
+      console.warn("Warning: Git initialization failed");
+    }
+  }
+  if (install) {
+    await execAsync("npm install", { cwd: targetDir });
+  }
+}
+
+// src/templates.ts
+var TEMPLATES = {
+  react: "gh:BodhiSearch/template-bodhi-react-vite"
+  // Future templates
+  // svelte: 'gh:BodhiSearch/template-bodhi-svelte-vite',
+  // vue: 'gh:BodhiSearch/template-bodhi-vue-vite',
+};
+function resolveTemplate(name) {
+  if (TEMPLATES[name]) {
+    return TEMPLATES[name];
+  }
+  if (name.includes(":")) {
+    return name;
+  }
+  throw new Error(
+    `Unknown template: ${name}
+
+Available templates:
+${Object.keys(TEMPLATES).map((t) => `  - ${t}`).join("\n")}
+
+Or use a custom template: gh:user/repo`
+  );
+}
+
+// src/cli.ts
+async function create(projectName, options) {
+  console.log();
+  p.intro(pc.bgCyan(pc.black(" create-bodhi-js ")));
+  let targetDir = projectName;
+  const template = options.template;
+  if (!targetDir) {
+    const result = await p.text({
+      message: "Project name:",
+      placeholder: "my-bodhi-app",
+      validate: (value) => {
+        if (!value) return "Project name is required";
+        if (!/^[a-z0-9-]+$/.test(value)) return "Use lowercase letters, numbers, and hyphens only";
+        return void 0;
+      }
+    });
+    if (p.isCancel(result)) {
+      p.cancel("Operation cancelled");
+      process.exit(0);
+    }
+    targetDir = result;
+  }
+  let templateUrl;
+  try {
+    templateUrl = resolveTemplate(template);
+  } catch (error) {
+    p.log.error(error.message);
+    process.exit(1);
+  }
+  let enableGithubPages = options.githubPages ?? false;
+  if (!options.githubPages) {
+    const result = await p.confirm({
+      message: "Enable GitHub Pages deployment?",
+      initialValue: false
+    });
+    if (p.isCancel(result)) {
+      p.cancel("Operation cancelled");
+      process.exit(0);
+    }
+    enableGithubPages = result;
+  }
+  let githubOrg = "";
+  let basePath = "/";
+  let pathSegmentsToKeep = 0;
+  if (enableGithubPages) {
+    const orgResult = await p.text({
+      message: "GitHub organization/username:",
+      placeholder: "my-org"
+    });
+    if (p.isCancel(orgResult)) {
+      p.cancel("Operation cancelled");
+      process.exit(0);
+    }
+    githubOrg = orgResult;
+    basePath = `/${targetDir}/`;
+    pathSegmentsToKeep = 1;
+  }
+  const spinner2 = p.spinner();
+  spinner2.start("Scaffolding project...");
+  try {
+    await scaffold({
+      projectName: targetDir,
+      templateUrl,
+      githubOrg,
+      githubPages: enableGithubPages,
+      basePath,
+      pathSegmentsToKeep,
+      install: options.install,
+      git: options.git
+    });
+    spinner2.stop("Project scaffolded successfully!");
+    p.note(
+      [`cd ${targetDir}`, !options.install && "npm install", "npm run dev"].filter(Boolean).join("\n"),
+      "Next steps"
+    );
+    p.outro(pc.green("Happy coding! \u{1F680}"));
+  } catch (error) {
+    spinner2.stop("Failed to scaffold project");
+    p.log.error(error.message);
+    process.exit(1);
+  }
+}
+
+// src/index.ts
+var program = new Command();
+program.name("create-bodhi-js").description("Scaffold Bodhi-powered applications").version("0.1.0").argument("[project-name]", "Name of the project").option("-t, --template <name>", "Template to use (react, svelte, vue)", "react").option("--no-install", "Skip dependency installation").option("--no-git", "Skip git initialization").option("--github-pages", "Enable GitHub Pages deployment setup").action(async (projectName, options) => {
+  await create(projectName, options);
+});
+program.parse();

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "create-bodhi-js",
+  "version": "0.1.0",
+  "description": "Scaffold Bodhi-powered applications with React, TypeScript, Vite, and more",
+  "type": "module",
+  "bin": {
+    "create-bodhi-js": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --max-warnings 0",
+    "lint:fix": "eslint . --fix",
+    "check": "npm run lint && npm run typecheck",
+    "check:fix": "npm run lint:fix && npm run typecheck",
+    "test": "echo \"Tests coming soon\" && exit 0",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "create-bodhi-js",
+    "bodhi",
+    "bodhi-js",
+    "react",
+    "vite",
+    "typescript",
+    "template",
+    "scaffolding",
+    "cli"
+  ],
+  "author": "BodhiSearch",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BodhiSearch/create-bodhi-js.git"
+  },
+  "bugs": {
+    "url": "https://github.com/BodhiSearch/create-bodhi-js/issues"
+  },
+  "homepage": "https://github.com/BodhiSearch/create-bodhi-js#readme",
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "commander": "^14.0.2",
+    "giget": "^2.0.0",
+    "handlebars": "^4.7.8",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^25.0.3",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "globals": "^17.0.0",
+    "prettier": "^3.7.4",
+    "tsup": "^8.5.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.46.4"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}