# Telegram-Mini-Apps/tma.js

Made from scratch TypeScript packages, examples and documentation you will surely need to start developing on Telegram Mini Apps.

Repository: https://github.com/Telegram-Mini-Apps/tma.js
Canonical: https://ross.abutalabs.com/products/tmajs
Homepage: https://docs.telegram-mini-apps.com/
Language: TypeScript
License: MIT
License Family: permissive
Topics: telegram, javascript, node, typescript, telegram-mini-apps
Last push: 2026-07-14T10:00:40+00:00

## Health v2 (maintenance only)
Score: 90/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 92, release rhythm 81, longevity 99
- inputs: {"age_days": 1395, "days_push": 50, "days_rel": 50, "gap_med": 0.0, "n_releases_24m": 515}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1193, forks 392 (observed 2026-08-28T04:03:56.523900+00:00)

## What it is
A monorepo of TypeScript packages, examples, and documentation for developing Telegram Mini Apps—web applications running inside Telegram clients. It serves as a higher-quality alternative to the official telegram-web-app.js SDK, covering both client-side and backend development.

## Use cases
- build a Telegram Mini App in TypeScript
- replace the official telegram-web-app.js SDK with a typed alternative
- integrate a web app with Telegram bot functionality
- learn how the Telegram Mini Apps platform works
- develop a native-like web app inside Telegram clients
- handle Telegram Mini App init data on a backend

## When to choose
- you want type-safe, well-structured packages for Telegram Mini Apps development
- you find the official Telegram SDK too limited or low-quality
- you need both client-side and server-side tooling for Mini Apps
- you want community documentation and examples to learn the platform

## When to avoid
- you only need simple, one-off Telegram bot scripts without a web app
- you prefer to use only the official Telegram SDK
- your project is not related to Telegram at all

## Facets
- artifact type: library
- maturity: active
- function: sdk, developer-tools, frontend-framework
- domain: developer-tools, web-development, messaging-platforms, apis
- platform: cross-platform
- tags: telegram-mini-apps, telegram-bot, monorepo, webview-apps, typescript-packages, typescript, nodejs, web-server

## Member repositories
- Telegram-Mini-Apps/tma.js (main) score 90

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:56.523900+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:22:12.703004+00:00, confidence not recorded.
  - readme: https://github.com/Telegram-Mini-Apps/tma.js (fetched 2026-08-28T04:03:56.523900+00:00, sha 21a1b3c44bb9)
  - homepage: https://docs.telegram-mini-apps.com/ (fetched 2026-08-29T12:29:27.663496+00:00, sha ad9d5c72b6fd)
  - site_page: https://docs.telegram-mini-apps.com/platform/about (fetched 2026-08-29T12:29:27.665923+00:00, sha ac97bc168b03)
- Data as of 2026-08-30T08:39:29.467469+00:00.