create-x402-app 0.1.1

package/README.md

@@ -0,0 +1,81 @@
+# create-x402-app
+
+Create a new x402 pay-per-request API project with one command.
+
+## Quick Start
+
+```bash
+npx create-x402-app my-app
+cd my-app
+npm run dev
+```
+
+## Usage
+
+### Interactive Mode
+
+```bash
+npx create-x402-app
+```
+
+This will prompt you for:
+- Project name
+- Package manager (npm, yarn, pnpm, bun)
+- Whether to install dependencies
+
+### With Arguments
+
+```bash
+# Create project with specific name
+npx create-x402-app my-api
+
+# Use specific package manager
+npx create-x402-app my-api --bun
+npx create-x402-app my-api --pnpm
+npx create-x402-app my-api --yarn
+
+# Skip dependency installation
+npx create-x402-app my-api --skip-install
+```
+
+## What's Included
+
+The generated project includes:
+
+- **Next.js 16** with App Router
+- **x402-mantle-sdk** for HTTP 402 payments
+- **TypeScript** configuration
+- **Tailwind CSS** for styling
+- **Example API routes**:
+  - `/api/info` - Free endpoint
+  - `/api/premium` - Paid endpoint (0.001 MNT)
+  - `/api/weather` - Paid endpoint (0.0005 MNT)
+- **Demo frontend** with wallet connection
+
+## After Creating
+
+1. **Get your App ID**
+   - Visit [https://mantle-x402.vercel.app](https://mantle-x402.vercel.app)
+   - Connect your wallet
+   - Create a project
+   - Copy your App ID
+
+2. **Configure environment**
+   ```bash
+   cp .env.example .env
+   # Edit .env with your App ID
+   ```
+
+3. **Start development**
+   ```bash
+   npm run dev
+   ```
+
+## Learn More
+
+- [x402 Documentation](https://mantle-x402.vercel.app)
+- [x402-mantle-sdk on npm](https://www.npmjs.com/package/x402-mantle-sdk)
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,374 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// package.json
+var require_package = __commonJS({
+  "package.json"(exports2, module2) {
+    module2.exports = {
+      name: "create-x402-app",
+      version: "0.1.1",
+      description: "Create a new x402 pay-per-request API project",
+      keywords: [
+        "x402",
+        "http-402",
+        "payment",
+        "api",
+        "mantle",
+        "web3",
+        "blockchain",
+        "create",
+        "cli",
+        "boilerplate",
+        "starter"
+      ],
+      author: "",
+      license: "MIT",
+      repository: {
+        type: "git",
+        url: "https://github.com/anthropics/x402"
+      },
+      bin: {
+        "create-x402-app": "./dist/index.js"
+      },
+      files: [
+        "dist",
+        "template"
+      ],
+      scripts: {
+        build: "tsup",
+        dev: "tsup --watch",
+        prepublishOnly: "npm run build"
+      },
+      dependencies: {
+        "@types/figlet": "^1.7.0",
+        chalk: "^5.3.0",
+        commander: "^12.1.0",
+        figlet: "^1.9.4",
+        "fs-extra": "^11.2.0",
+        ora: "^8.0.1",
+        prompts: "^2.4.2"
+      },
+      devDependencies: {
+        "@types/fs-extra": "^11.0.4",
+        "@types/node": "^20.0.0",
+        "@types/prompts": "^2.4.9",
+        tsup: "^8.0.0",
+        typescript: "^5.0.0"
+      }
+    };
+  }
+});
+
+// src/index.ts
+var import_commander = require("commander");
+var import_chalk = __toESM(require("chalk"));
+var import_ora = __toESM(require("ora"));
+var import_prompts = __toESM(require("prompts"));
+var import_fs_extra = __toESM(require("fs-extra"));
+var import_path = __toESM(require("path"));
+var import_child_process = require("child_process");
+var import_figlet = __toESM(require("figlet"));
+var packageJson = require_package();
+function getTemplateDir(projectType, framework) {
+  return `${projectType}-${framework}`;
+}
+function showBanner() {
+  return new Promise((resolve) => {
+    import_figlet.default.text("x402", {
+      font: "ANSI Shadow",
+      horizontalLayout: "default",
+      verticalLayout: "default"
+    }, (err, data) => {
+      console.log();
+      if (!err && data) {
+        const lines = data.split("\n");
+        const colors = [import_chalk.default.hex("#00D4FF"), import_chalk.default.hex("#00BFFF"), import_chalk.default.hex("#00A5FF"), import_chalk.default.hex("#008BFF"), import_chalk.default.hex("#0070FF"), import_chalk.default.hex("#0055FF"), import_chalk.default.hex("#003AFF")];
+        lines.forEach((line, i) => {
+          const color = colors[Math.min(i, colors.length - 1)];
+          console.log(color(line));
+        });
+      } else {
+        console.log(import_chalk.default.bold.cyan("  x402"));
+      }
+      console.log();
+      console.log(import_chalk.default.bold.white("  mantle-sdk"));
+      console.log();
+      console.log(import_chalk.default.gray("  \u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E"));
+      console.log(import_chalk.default.gray("  \u2502"), import_chalk.default.cyan(" Build pay-per-request APIs with HTTP 402 protocol "), import_chalk.default.gray("\u2502"));
+      console.log(import_chalk.default.gray("  \u2502"), import_chalk.default.white("           Powered by Mantle Network                "), import_chalk.default.gray("\u2502"));
+      console.log(import_chalk.default.gray("  \u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F"));
+      console.log();
+      console.log(import_chalk.default.gray(`  v${packageJson.version}`));
+      console.log();
+      resolve();
+    });
+  });
+}
+async function main() {
+  await showBanner();
+  import_commander.program.name("create-x402-app").description("Create a new x402 pay-per-request API project").version(packageJson.version).argument("[project-name]", "Name of your project").option("--fullstack", "Create a fullstack project").option("--backend", "Create a backend-only project").option("--hono", "Use Hono framework").option("--express", "Use Express framework").option("--npm", "Use npm as package manager").option("--yarn", "Use yarn as package manager").option("--pnpm", "Use pnpm as package manager").option("--bun", "Use bun as package manager").option("--skip-install", "Skip installing dependencies").parse();
+  const args = import_commander.program.args;
+  const options = import_commander.program.opts();
+  let projectName = args[0];
+  let projectType;
+  let framework;
+  let packageManager = "npm";
+  let installDeps = !options.skipInstall;
+  if (options.fullstack) projectType = "fullstack";
+  if (options.backend) projectType = "backend";
+  if (options.hono) framework = "hono";
+  if (options.express) framework = "express";
+  let packageManagerFromFlag = false;
+  if (options.npm) {
+    packageManager = "npm";
+    packageManagerFromFlag = true;
+  } else if (options.yarn) {
+    packageManager = "yarn";
+    packageManagerFromFlag = true;
+  } else if (options.pnpm) {
+    packageManager = "pnpm";
+    packageManagerFromFlag = true;
+  } else if (options.bun) {
+    packageManager = "bun";
+    packageManagerFromFlag = true;
+  }
+  if (!projectName) {
+    const { name } = await (0, import_prompts.default)({
+      type: "text",
+      name: "name",
+      message: "What is your project name?",
+      initial: "my-x402-app",
+      validate: (value) => {
+        if (!value) return "Project name is required";
+        if (!/^[a-z0-9-_]+$/i.test(value)) {
+          return "Project name can only contain letters, numbers, hyphens, and underscores";
+        }
+        return true;
+      }
+    }, {
+      onCancel: () => {
+        console.log(import_chalk.default.red("\n\u2716 Project creation cancelled."));
+        process.exit(1);
+      }
+    });
+    projectName = name;
+  }
+  if (!projectType) {
+    const { type } = await (0, import_prompts.default)({
+      type: "select",
+      name: "type",
+      message: "What type of project?",
+      choices: [
+        {
+          title: "Fullstack",
+          value: "fullstack",
+          description: "Next.js frontend + API routes with x402"
+        },
+        {
+          title: "Backend only",
+          value: "backend",
+          description: "Standalone API server with x402"
+        }
+      ],
+      initial: 0
+    }, {
+      onCancel: () => {
+        console.log(import_chalk.default.red("\n\u2716 Project creation cancelled."));
+        process.exit(1);
+      }
+    });
+    projectType = type;
+  }
+  if (!framework) {
+    const { fw } = await (0, import_prompts.default)({
+      type: "select",
+      name: "fw",
+      message: "Which framework?",
+      choices: [
+        {
+          title: "Hono",
+          value: "hono",
+          description: "Fast, lightweight, Web Standards"
+        },
+        {
+          title: "Express",
+          value: "express",
+          description: "Popular, mature, extensive ecosystem"
+        }
+      ],
+      initial: 0
+    }, {
+      onCancel: () => {
+        console.log(import_chalk.default.red("\n\u2716 Project creation cancelled."));
+        process.exit(1);
+      }
+    });
+    framework = fw;
+  }
+  if (!packageManagerFromFlag) {
+    const response = await (0, import_prompts.default)([
+      {
+        type: "select",
+        name: "packageManager",
+        message: "Package manager:",
+        choices: [
+          { title: "npm", value: "npm" },
+          { title: "yarn", value: "yarn" },
+          { title: "pnpm", value: "pnpm" },
+          { title: "bun", value: "bun" }
+        ],
+        initial: 0
+      },
+      {
+        type: "confirm",
+        name: "installDeps",
+        message: "Install dependencies?",
+        initial: true
+      }
+    ], {
+      onCancel: () => {
+        console.log(import_chalk.default.red("\n\u2716 Project creation cancelled."));
+        process.exit(1);
+      }
+    });
+    packageManager = response.packageManager;
+    installDeps = response.installDeps;
+  }
+  if (!projectName || !projectType || !framework) {
+    console.log(import_chalk.default.red("\n\u2716 Missing required options."));
+    process.exit(1);
+  }
+  const projectPath = import_path.default.resolve(process.cwd(), projectName);
+  const templateName = getTemplateDir(projectType, framework);
+  console.log();
+  console.log(import_chalk.default.bold("  Project Configuration"));
+  console.log(import_chalk.default.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(import_chalk.default.gray("  Name:     "), import_chalk.default.cyan(projectName));
+  console.log(import_chalk.default.gray("  Type:     "), import_chalk.default.white(projectType));
+  console.log(import_chalk.default.gray("  Framework:"), import_chalk.default.white(framework));
+  console.log(import_chalk.default.gray("  Package:  "), import_chalk.default.white(packageManager));
+  console.log();
+  if (import_fs_extra.default.existsSync(projectPath)) {
+    const { overwrite } = await (0, import_prompts.default)({
+      type: "confirm",
+      name: "overwrite",
+      message: `Directory ${import_chalk.default.cyan(projectName)} already exists. Overwrite?`,
+      initial: false
+    });
+    if (!overwrite) {
+      console.log(import_chalk.default.red("\n\u2716 Project creation cancelled."));
+      process.exit(1);
+    }
+    import_fs_extra.default.removeSync(projectPath);
+  }
+  const spinner = (0, import_ora.default)("Creating project...").start();
+  try {
+    const templatePath = import_path.default.join(__dirname, "..", "templates", templateName);
+    if (!import_fs_extra.default.existsSync(templatePath)) {
+      spinner.fail(`Template not found: ${templateName}`);
+      console.log(import_chalk.default.yellow(`
+Available templates:`));
+      const templatesDir = import_path.default.join(__dirname, "..", "templates");
+      if (import_fs_extra.default.existsSync(templatesDir)) {
+        const templates = import_fs_extra.default.readdirSync(templatesDir);
+        templates.forEach((t) => console.log(import_chalk.default.gray(`  \u2022 ${t}`)));
+      }
+      process.exit(1);
+    }
+    import_fs_extra.default.copySync(templatePath, projectPath);
+    const pkgPath = import_path.default.join(projectPath, "package.json");
+    if (import_fs_extra.default.existsSync(pkgPath)) {
+      const pkg = import_fs_extra.default.readJsonSync(pkgPath);
+      pkg.name = projectName;
+      import_fs_extra.default.writeJsonSync(pkgPath, pkg, { spaces: 2 });
+    }
+    const gitignoreVariants = ["_gitignore", "gitignore"];
+    for (const variant of gitignoreVariants) {
+      const gitignorePath = import_path.default.join(projectPath, variant);
+      if (import_fs_extra.default.existsSync(gitignorePath)) {
+        import_fs_extra.default.renameSync(gitignorePath, import_path.default.join(projectPath, ".gitignore"));
+        break;
+      }
+    }
+    const envExampleVariants = ["_env.example", "env.example"];
+    for (const variant of envExampleVariants) {
+      const envExamplePath = import_path.default.join(projectPath, variant);
+      if (import_fs_extra.default.existsSync(envExamplePath)) {
+        import_fs_extra.default.renameSync(envExamplePath, import_path.default.join(projectPath, ".env.example"));
+        break;
+      }
+    }
+    spinner.succeed("Project created!");
+    if (installDeps) {
+      const installSpinner = (0, import_ora.default)("Installing dependencies...").start();
+      try {
+        const installCmd = {
+          npm: "npm install",
+          yarn: "yarn",
+          pnpm: "pnpm install",
+          bun: "bun install"
+        }[packageManager];
+        (0, import_child_process.execSync)(installCmd, {
+          cwd: projectPath,
+          stdio: "pipe"
+        });
+        installSpinner.succeed("Dependencies installed!");
+      } catch (error) {
+        installSpinner.fail("Failed to install dependencies");
+        console.log(import_chalk.default.yellow("\nYou can install them manually:"));
+        console.log(import_chalk.default.cyan(`  cd ${projectName}`));
+        console.log(import_chalk.default.cyan(`  ${packageManager} install`));
+      }
+    }
+    const runCmd = packageManager === "npm" ? "npm run" : packageManager;
+    console.log();
+    console.log(import_chalk.default.green.bold("\u2714 Success!"), `Created ${import_chalk.default.cyan(projectName)}`);
+    console.log();
+    console.log(import_chalk.default.bold("  Next steps:"));
+    console.log();
+    console.log(import_chalk.default.gray("  1."), import_chalk.default.cyan(`cd ${projectName}`));
+    if (!installDeps) {
+      console.log(import_chalk.default.gray("  2."), import_chalk.default.cyan(`${packageManager} install`));
+      console.log(import_chalk.default.gray("  3."), import_chalk.default.cyan("cp .env.example .env"));
+      console.log(import_chalk.default.gray("  4."), "Get your App ID from", import_chalk.default.underline("https://mantle-x402.vercel.app"));
+      console.log(import_chalk.default.gray("  5."), import_chalk.default.cyan(`${runCmd} dev`));
+    } else {
+      console.log(import_chalk.default.gray("  2."), import_chalk.default.cyan("cp .env.example .env"));
+      console.log(import_chalk.default.gray("  3."), "Get your App ID from", import_chalk.default.underline("https://mantle-x402.vercel.app"));
+      console.log(import_chalk.default.gray("  4."), import_chalk.default.cyan(`${runCmd} dev`));
+    }
+    console.log();
+    console.log(import_chalk.default.gray("  Documentation:"), import_chalk.default.underline("https://mantle-x402.vercel.app"));
+    console.log();
+  } catch (error) {
+    spinner.fail("Failed to create project");
+    console.error(error);
+    process.exit(1);
+  }
+}
+main().catch(console.error);

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "create-x402-app",
+  "version": "0.1.1",
+  "description": "Create a new x402 pay-per-request API project",
+  "keywords": [
+    "x402",
+    "http-402",
+    "payment",
+    "api",
+    "mantle",
+    "web3",
+    "blockchain",
+    "create",
+    "cli",
+    "boilerplate",
+    "starter"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anthropics/x402"
+  },
+  "bin": {
+    "create-x402-app": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "template"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@types/figlet": "^1.7.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "figlet": "^1.9.4",
+    "fs-extra": "^11.2.0",
+    "ora": "^8.0.1",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^20.0.0",
+    "@types/prompts": "^2.4.9",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}