Telegram Mini-App Boilerplate (React 19 + Telegraf + TON)

The fastest way to build Telegram Mini-Apps (TMA)

Production-ready boilerplate for building Web3 and native Telegram Mini-Apps. Ships with React 19 + Vite frontend running inside the Telegram Web App container, a Node.js + Telegraf backend, and TON wallet integration.

Features

• React 19 + Vite frontend inside Telegram Web App container
• Node.js + Telegraf backend with Express API
• TON wallet integration (Web3 ready)
• InitData validation (security)
• Cloud Storage sync for user data
• Native UI elements (MainButton, HapticFeedback)
• Monorepo with concurrently dev script

Quick Start

npm install && cd frontend && npm install && cd ../backend && npm install && cd ..
cp backend/.env.example backend/.env
npm run dev

Stack

React 19 · Vite · Node.js · Telegraf · Express · TON Web3