Telegram Bot Builder (V2) 🤖

Comprehensive toolkit for building production-grade Telegram bots + Mini Apps in Node.js / TypeScript.

This repository is a collection of templates, recipes, and references designed for use with the grammY framework and the modern Telegram Mini App SDK.

📂 Project Structure

• templates/: Base skeletons for different parts of your project.
  • monorepo/: Root configuration for a pnpm + Turborepo setup.
  • bot/: Cloudflare Worker + Hono + grammY.
  • miniapp/: Vite + React + TS + @telegram-apps/sdk.
  • db/: Drizzle ORM + Neon/Postgres schema.
• recipes/: End-to-end patterns for common bot types (Ecommerce, AI, Paywalls, etc.).
• references/: Technical deep-dives into the Bot API, Mini Apps, Payments, and Security.
• scripts/: Automation tools for setup, webhooks, and validation.
• SKILL.md: The decision core and master documentation for the builder.

🚀 Quick Start

To start a new project from these templates:

1. Scaffold the Monorepo:

   mkdir my-new-bot && cd my-new-bot
   cp -r ../templates/monorepo/* .
   cp -r ../templates/monorepo/.[a-z]* . # copy hidden files

2. Add Apps and Packages:

   mkdir -p apps/bot apps/miniapp packages/db packages/shared
   cp -r ../templates/bot/* apps/bot/
   cp -r ../templates/miniapp/* apps/miniapp/
   cp -r ../templates/db/* packages/db/

3. Install Dependencies:

   pnpm install

4. Follow the Setup Guides:

   • Refer to references/botfather-flow.md for manual Telegram setup.
   • Use templates/README.md for a detailed order of operations.

🛠️ Stack

• Bot Framework: grammY
• Runtime: Cloudflare Workers (Hono)
• Frontend: React + Vite
• Database: Drizzle ORM + Neon
• Package Management: pnpm + Turborepo

🛡️ Security

Always refer to references/security.md before deploying. This stack enforces mandatory initData validation and secure webhook handling.

---

Generated for use with the Telegram Bot Builder Skill.