Documentation

Export a Pattern

Download a runnable Hono API server or copy its critical server files as AI-friendly Markdown.

Supported patterns expose Hono in both the Download and Copy skill files menus. Both actions are generated from the same verified server file set.

Download or copy

ActionOutputBest for
Download → Hono API serverRunnable .zip projectRunning, testing, or deploying the service
Copy skill files → Hono API serverAI-friendly MarkdownAdding the server to an existing repository with an AI coding tool

If a pattern has not passed Hono verification, its Hono action is unavailable. See Compatibility & Limitations for details.

Download a runnable server

  1. Open a supported pattern.
  2. Open the Download menu.
  3. Choose Hono API server.
  4. Extract <pattern-name>-hono.zip.
  5. Copy .env.example to .env and fill the required values.
  6. Install and run the project:
pnpm install
pnpm typecheck
pnpm dev

A typical archive looks like this:

<pattern-name>-hono/
├── src/
│   ├── index.ts
│   └── ...pattern server files
├── .env.example
├── .gitignore
├── package.json
├── pnpm-lock.yaml              # when included
├── README.md
└── tsconfig.json

The source files may retain paths such as src/app/api/.../route.ts. That is intentional: the generated src/index.ts imports the existing Web-standard route handler and mounts it directly in Hono without rewriting the pattern's AI logic.

Inspect the generated README

The README is specific to the exported pattern. Review it before running the server because it records:

  • every HTTP method and route
  • required and optional environment variables
  • whether authentication is included or consumer-required
  • whether rate limiting is included or consumer-required
  • declared request-abort behavior
  • the default host and port

The archive never includes real secret values. Add credentials to .env, keep that file out of source control, and configure production secrets through your host.

Copy the Hono server files

Choose Copy skill files → Hono API server to copy Markdown containing the critical text files from the runnable export. Paste it into your AI coding tool with a scoped request, for example:

Add this Hono API server to my existing workspace. Preserve its routes and streaming behavior, use our environment-loading convention, and do not copy any React or Next.js UI files.

If browser clipboard access is blocked, the pattern page opens a selectable fallback and lets you download the payload as a .md file.

Verify the service

With the server running, first check its health endpoint:

curl http://127.0.0.1:3001/healthz

Expected response:

{ "ok": true }

Then call the pattern route listed in the README or connect your frontend.