grammy-bot-template
Описание
Мини-фреймворк для создания проектов на grammY и bun
Языки
- TypeScript100%
grammY Bot Template
Opinionated template для Telegram-бота на .
Идея простая: оставить силу , но убрать повторяющийся bootstrap-код, регистрацию команд, базовые middleware и разрозненную структуру проекта. В результате получается легкий мини-фреймворк, где бот собирается из независимых -модулей.
Что уже есть
- модульная архитектура через defineFeature(...)
- общий
иAppContextsession - auto-retry, hydration, logging, error handler
- синхронизация команд с Telegram при старте
- graceful shutdown
- примеры модулей:
,start,helpping
Быстрый старт
Заполни и запускай:
Файл для агентов
В репозитории есть один агентский файл: . В нем собраны правила работы с шаблоном, архитектурные ограничения и заготовка для новых -модулей.
Структура
Как добавлять функциональность
Каждая фича оформляется как отдельный модуль:
Дальше достаточно экспортировать модуль из .
Почему это не просто голый grammY
Этот шаблон берет на себя инфраструктурную часть:
- единый вход в приложение
- базовые middleware
- общую типизацию контекста
- автосборку команд из модулей
- предсказуемую структуру директорий
При этом ты не теряешь API : внутри используется обычный , поэтому любые middleware, conversations, menus и плагины можно добавлять без борьбы с абстракцией.