Skip to content

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

License

Notifications You must be signed in to change notification settings

JResquid/telegram-apps

 
 

Repository files navigation

@telegram-apps

Commitizen friendly

Mono-repository, containing all the packages, connected with comfortable and safe TypeScript development on Telegram Mini Apps platform. To learn more about specific packages, follow their own documentations.

⚠️ Working with @telegram-apps packages, you must not install the SDK from Telegram presented by a single file - telegram-web-app.js. Using both @telegram-apps packages and telegram-web-app.js will surely lead to bugs.

Packages

@telegram-apps/sdk

docs-badge sdk-npm-badge Size code-badge

Made from scratch TypeScript library for seamless communication with Telegram Mini Apps functionality.

The code of this library is designed to simplify the process of developers interacting with Telegram Mini Apps. It consists of several individual components, each responsible for a specific aspect of the Telegram Mini Apps ecosystem.

Before you begin using the SDK, we highly recommend familiarizing yourself with the Telegram Mini Apps documentation to grasp the fundamental concepts of the platform.

@telegram-apps/sdk-react

docs-badge sdk-react-npm-badge Size code-badge

React JS bindings for client SDK. Includes hooks, components and utilities for comfortable usage of React JS on the Telegram Mini Apps platform.

@telegram-apps/sdk-solid

docs-badge sdk-solid-npm-badge Size code-badge

Solid JS bindings for client SDK. Includes hooks, components and utilities for comfortable usage of Solid JS on the Telegram Mini Apps platform.

@telegram-apps/init-data-node

docs-badge init-data-node-npm-badge Size code-badge

The package provides utilities to work with the initialization data of Telegram Mini Apps on the server side. To learn more about the initialization data and its usage, please refer to the documentation.

@telegram-apps/solid-router-integration

docs-badge solid-router-integration-npm-badge Size code-badge

Telegram Mini Apps Navigator integration for @solidjs/router.

@telegram-apps/react-router-integration

docs-badge react-router-integration-npm-badge Size code-badge

Telegram Mini Apps Navigator integration for react-router-dom.

Why not Telegram SDK

Why bother creating a project like @telegram-apps when there are existing solutions from the developers who own the platform? The answer is rather simple: the currently provided solution (SDK) does not seem to meet the required minimum quality standards. Of course, the term 'quality' is rather specific and subjective, but this section should make it more objective.

This project was born during the research of a solution provided by Telegram - telegram-web-app.js, which is considered the only existing official SDK for Telegram Mini Apps by Telegram. Therefore, all the points described in this section will be related to this package.

Because of the large section size, the complete motivation description has been moved to a separate document.

Contribution

Any contribution is appreciated. To start contributing, please, follow the Contribution Guidelines.

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 98.0%
  • Other 2.0%