ForgeTelegramApp

A basic boilerplate, containing all the requirements to build and ship Telegram web apps on top of Cloudflare Workers.

Warning: This project is not production-ready and is only meant to be used as a starting point for building Telegram web apps.

Backend

• Hono for API routing
• Drizzle for database
• Zod for data validation
• Trpc for API
• Neon for Postgres
• Vitest for testing

How to run for development

pnpm install
pnpm run dev

Deploying to production

pnpm deploy

Testing

pnpm test {test-name?}

---

Frontend

• React
• TailwindCSS
• Shadcn
• Tanstack Query
• Tanstack Router
• Telegram Web Apps

How to run for development

In order to run and preview the frontend, you need to spin up ngrok so that you can directly view the web app in Telegram.

pnpm install
pnpm run dev

You also need to send /test {ngrok-url} to the bot, in order to get the web app url.

---

Telegram Bot

A basic implementation of a Telegram bot using Hono as the backend router.

• Hono for API routing
• Telegram Bot