# Быстрый старт с BotPages

Это руководство поможет быстро запустить demo?приложение с Telegram?адаптером.

Требования
- .NET 8 SDK
- Токен Telegram?бота (для demo)

Сборка

```bash
dotnet build
```

Запуск demo

1. Установите переменную окружения `TELEGRAM_TOKEN`:

```bash
setx TELEGRAM_TOKEN "<token>"   # Windows
export TELEGRAM_TOKEN="<token>" # Linux/macOS
```

2. Запустите demo:

```bash
dotnet run --project Demo
```

Пример конфигурации приложения

```csharp
var app = new BotPagesApp(stateStorage, logger)
    .AddTelegramAdapter(token)
    .AddDefaultPage<WelcomePage>()
    .MapCommand<WelcomePage>("/start")
    .AddMiddleware(new LoggingMiddleware(logger));

await app.Build(CancellationToken.None);
```

Основные понятия
- `SendRequest` — единый формат запроса на отправку (текст, файлы, кнопки, адаптер?опции). Используйте `PageContext.SendAsync` для отправки.
- `Page` / `StatefulPage` / `SingletonPage` — модели страниц и их жизненный цикл.
- `IPageMiddleware` — middleware выполняется для каждого входящего обновления.

Далее: см. `docs/API_REFERENCE.md` для описания публичных API.