เพิ่ม Stack Template · Adding a template

// src/data/templates/hono-api.ts
import type { StackTemplate } from "@/lib/types";
import { mkdirAndCd, npmInit } from "../common-steps";

const server = `import { serve } from "@hono/node-server";
import { Hono } from "hono";

const app = new Hono();
app.get("/health", (c) => c.json({ ok: true, service: "{{name}}" }));

serve({ fetch: app.fetch, port: Number(process.env.PORT) || 3000 }, (info) =>
  console.log("API ready on http://localhost:" + info.port)
);
`;

const template: StackTemplate = {
  id: "hono-api",
  name: { en: "Hono API on Node", th: "API ด้วย Hono บน Node" },
  summary: {
    en: "A tiny Hono web API running on Node with a health check.",
    th: "Web API ขนาดเล็กด้วย Hono รันบน Node พร้อม health check",
  },
  category: "api",
  runtimes: ["node"],
  tags: ["Node.js", "Hono", "API"],
  supportedAddons: ["testing", "docker", "ci"],
  defaultAddons: [],
  defaultName: "nvx-hono-api",
  keywords: ["hono", "api", "edge", "เอพีไอ", "หลังบ้าน"],
  fileTree: ["{{name}}/", "  src/index.js", "  package.json"],
  steps: [
    mkdirAndCd,
    npmInit,
    {
      id: "hono-deps",
      title: { en: "Install Hono", th: "ติดตั้ง Hono" },
      explanation: {
        en: "hono is the router; @hono/node-server adapts it to Node's HTTP server.",
        th: "hono คือ router ส่วน @hono/node-server ทำให้รันบน HTTP server ของ Node ได้",
      },
      commands: ["{{add}} hono @hono/node-server"],
      expected: { en: "hono is in dependencies.", th: "hono อยู่ใน dependencies" },
      verify: "{{list}} hono",
    },
    {
      id: "hono-scripts",
      title: { en: "Enable ES modules and scripts", th: "เปิด ES modules และเพิ่ม scripts" },
      explanation: {
        en: "Use import syntax and add a dev script that restarts on save.",
        th: "ใช้ import และเพิ่ม script dev ที่รีสตาร์ทเมื่อบันทึกไฟล์",
      },
      commands: ["npm pkg set type=module 'scripts.dev=node --watch src/index.js'"],
      expected: { en: "package.json has type=module.", th: "package.json มี type=module" },
      verify: "npm pkg get type",
    },
    {
      id: "hono-server",
      title: { en: "Write the server", th: "เขียนเซิร์ฟเวอร์" },
      explanation: { en: "One route: GET /health.", th: "มีเส้นทางเดียว: GET /health" },
      commands: [],
      files: [{ path: "src/index.js", content: server }],
      expected: { en: "src/index.js exists.", th: "มีไฟล์ src/index.js" },
      verify: "node --check src/index.js",
    },
    {
      id: "dev-server",
      title: { en: "Run the API", th: "รัน API" },
      explanation: { en: "Starts on port 3000.", th: "เปิดที่พอร์ต 3000" },
      commands: ["{{run}} dev"],
      kind: "longRunning",
      expected: { en: "Console prints: API ready", th: "คอนโซลแสดง: API ready" },
      verify: "curl http://localhost:3000/health",
    },
  ],
  nextSteps: [{ en: "Add zod validation.", th: "เพิ่มการตรวจข้อมูลด้วย zod" }],
  docs: [{ label: "Hono", url: "https://hono.dev" }],
  docker: { kind: "node", port: 3000, cmd: ["node", "src/index.js"] },
  ci: ["node --check src/index.js"],
};

export default template;

npm run export -- hono-api --out /tmp/nvx-try --addons testing,docker
bash -n /tmp/nvx-try/setup.sh                 # syntax check
cd /tmp/nvx-try && bash setup.sh              # end-to-end ในโฟลเดอร์สะอาด
npm run export -- hono-api --pm pnpm --out /tmp/nvx-pnpm
npm test && npm run typecheck && npm run docs:check