grammy-bot-template

Шаблон
0

Описание

Мини-фреймворк для создания проектов на grammY и bun

Шаблон

Используйте репозиторий как шаблон для создания нового репозитория

Языки

  • TypeScript100%
7 дней назад
7 дней назад
7 дней назад
7 дней назад
7 дней назад
7 дней назад
7 дней назад
7 дней назад
README.md

grammY Bot Template

Opinionated template для Telegram-бота на

Bun + TypeScript + grammY
.

Идея простая: оставить силу

grammy
, но убрать повторяющийся bootstrap-код, регистрацию команд, базовые middleware и разрозненную структуру проекта. В результате получается легкий мини-фреймворк, где бот собирается из независимых
feature
-модулей.

Что уже есть

  • модульная архитектура через
    defineFeature(...)
  • общий
    AppContext
    и
    session
  • auto-retry, hydration, logging, error handler
  • синхронизация команд с Telegram при старте
  • graceful shutdown
  • примеры модулей:
    start
    ,
    help
    ,
    ping

Быстрый старт

Заполни

BOT_TOKEN
и запускай:

Файл для агентов

В репозитории есть один агентский файл:

AGENTS.md
. В нем собраны правила работы с шаблоном, архитектурные ограничения и заготовка для новых
feature
-модулей.

Структура

Как добавлять функциональность

Каждая фича оформляется как отдельный модуль:

Дальше достаточно экспортировать модуль из

src/modules/index.ts
.

Почему это не просто голый grammY

Этот шаблон берет на себя инфраструктурную часть:

  • единый вход в приложение
  • базовые middleware
  • общую типизацию контекста
  • автосборку команд из модулей
  • предсказуемую структуру директорий

При этом ты не теряешь API

grammy
: внутри
setup(composer)
используется обычный
Composer
, поэтому любые middleware, conversations, menus и плагины можно добавлять без борьбы с абстракцией.