Kumala3/tg_miniapp_template

This template is used for development Telegram bots on aiogram v3.0+ + MiniApp on React & TypeScript

To start using it:

1. Register the account on ngrok(if you haven't yet): Sign Up Ngrok
2. Create ngrok.yml by data from ngrok-example.yml and fill out required data: authtoken and domain.
3. Create .env by data from .end.dist and fill out required data.
4. Run with Docker:
   1. Download and install Docker desktop (if you haven't yet): Download Docker Desktop.
   2. Run project with next command in terminal:
      docker-compose up --build

Як робити та реєструвати хендлери:

Створюєте модуль you_name.py у папці handlers.

Створюєте роутер у you_name.py.

from aiogram import Router
user_router = Router()

Можна робити декілька роутерів в одному модулі, та на кожний з них навішувати хендлери. Можна реєструвати хендлери декораторами:

@user_router.message(commands=["start"])
async def user_start(message):
    await message.reply("Вітаю, звичайний користувач!")

Заходимо у файл handlers/__init__.py і додаємо всі роутери в нього:

from .admin import admin_router
from .echo import echo_router
from .user import user_router

...


routers_list = [
    admin_router,
    user_router,
    echo_router,  # echo_router must be last
]

Як додати хендлери до нашого бота:

Переходимо до файлу bot.py та розпаковуємо наші хендлери:

from tgbot.handlers import routers_list

...

async def main():
   
    ...

   dp.include_routers(*routers_list)

    ...

Туторіали з aiogram v3

Відосів поки що немає, але @Groosha вже почав робити свій підручник.