Create Onchain

A CLI tool to bootstrap your Base onchain apps and Farcaster Mini-Apps with best practices and modern tooling.

🚀 Quickstart

Create a new project:

# Create an Onchainkit template
npx create-onchain

# Create a Mini-App template
npx create-onchain --mini

# Create a particular Mini-App template
npx create-onchain --template-<template>

Available Templates:
  - onchainkit-nextjs: Create a basic OnchainKit project
  - minikit-nextjs: Create a MiniKit project

# Generate a Mini-App manifest in existing project
npx create-onchain --manifest

# Show the available commands
npx create-onchain --help

# Show the current version
npx create-onchain --version

📦 Templates

Next.js Basic Template

A Next.js template with OnchainKit pre-configured for building Base onchain apps:

• Next.js 14+ with App Router
• OnchainKit components and hooks
• Wagmi for wallet connection
• Tailwind CSS for styling
• TypeScript support
• ESLint and Prettier configured

npx create-onchain
# Default template

MiniKit Template

A template optimized for building Farcaster Mini-Apps:

• Next.js 14+ with App Router
• MiniKit components and hooks
• Farcaster Frame utilities
• OnchainKit for Wallet Connection
• OnchainKit for sample Transaction
• Tailwind CSS for styling
• TypeScript support
• ESLint and Prettier configured

npx create-onchain --mini
# or
npx create-onchain --template=minikit-basic

🔧 Development

Requirements

• Node.js v18+
• pnpm v10+

Getting Started

1. Install dependencies

pnpm install

2. Start development

pnpm dev

3. Build

pnpm build

Testing

# Run tests
pnpm test

# Run with coverage
pnpm test:coverage

📖 Mini-App Manifest Generation

When using --manifest, the tool will:

1. Launch a UI to connect your Farcaster custody wallet
2. Generate and sign your manifest
3. Save it to your .env file as:
   • FARCASTER_HEADER
   • FARCASTER_PAYLOAD
   • FARCASTER_SIGNATURE

🌊 License

This project is licensed under the MIT License - see the LICENSE.md file for details