TMA.sh

Why TMA.sh?

Zero Config Deploys

Connect your GitHub repo, push to main, and your Telegram Mini App is live at yourapp.tma.sh in minutes.

Built-in Auth

Validate Telegram users and get signed JWTs. Works with Supabase, Firebase, and any backend out of the box.

Payments Ready

Accept payments via TON Connect and Telegram Stars with just a few lines of code.

Edge API Routes

Add a server/api/index.ts file and get an API deployed to the edge automatically. Use any framework or plain fetch handlers.

Most Important Pieces

• Static app + edge APIs: your frontend is served from {project}.tma.sh, and optional API routes from {project}--api.tma.sh (plus same-origin /api/* on project and preview hosts).
• Telegram-native auth: initData validation + signed JWTs via @tma.sh/sdk, with JWKS-based verification for server routes.
• One deploy pipeline: GitHub-based build/deploy flow for production and preview, with immutable deployments and instant route-based rollback.
• Built-in platform primitives: per-project KV, optional managed D1, bot handlers, environment-scoped secrets, analytics, and campaigns.

How it works

# Install the CLI
bun add -g @tma.sh/cli

# Create a new project
tma init my-app

# Link this folder to a TMA.sh project
cd my-app
tma link

# Start developing locally
tma dev

KV Storage

Simple key-value storage scoped per project. No database setup needed for common use cases.

Preview Environments

Select one PR as staging and deploy it to pr{number}--yourapp.tma.sh, with optional preview-bot support.

Instant Rollback

Roll back to any previous deployment instantly. No rebuilds, no downtime.

Custom Domains

Bring your own domain with automatic SSL certificates and global CDN.

Using an AI assistant?

This documentation is available as llms.txt and llms-full.txt for LLMs and AI coding tools.