Skip to content
Kotodayori

Installation

Prerequisites

Section titled “Prerequisites”
  • Node.js >= 18
  • Package manager: pnpm, npm, or yarn

Install by use case

Section titled “Install by use case”

Stripe with Hono

Section titled “Stripe with Hono”
Terminal window
pnpm add @kotodayori/stripe @kotodayori/hono stripe

Stripe with Express

Section titled “Stripe with Express”
Terminal window
pnpm add @kotodayori/stripe @kotodayori/express stripe

Stripe with AWS Lambda

Section titled “Stripe with AWS Lambda”
Terminal window
pnpm add @kotodayori/stripe @kotodayori/lambda stripe

Custom webhooks (without Stripe)

Section titled “Custom webhooks (without Stripe)”

Use the core router with any adapter:

Terminal window
pnpm add @kotodayori/core @kotodayori/hono
# or @kotodayori/express, @kotodayori/lambda

Runtime validation with Zod

Section titled “Runtime validation with Zod”

If you want runtime schema validation in addition to type safety:

Terminal window
pnpm add @kotodayori/stripe @kotodayori/zod @kotodayori/hono stripe zod

Scaffolding with create-kotodayori

Section titled “Scaffolding with create-kotodayori”

The fastest way to create a new project is with the scaffolding tool:

Terminal window
npx create-kotodayori

This will interactively guide you through creating a new Kotodayori project with your preferred framework and package manager.

You can also specify options directly:

Terminal window
# Create a new Hono-based webhook handler
npx create-kotodayori my-webhook-handler --fw=hono


# With custom package manager
npx create-kotodayori my-webhook-handler --fw=hono --pm=pnpm

Peer dependencies

Section titled “Peer dependencies”
  • Stripe adapter (@kotodayori/stripe): stripe >= 17.0.0
  • Hono adapter (@kotodayori/hono): hono >= 4.0.0
  • Express adapter (@kotodayori/express): express >= 4.0.0
  • Zod integration (@kotodayori/zod): zod ^4.0.0

Install the peer dependencies for the packages you use.