Abitly Telegram Mini App

Метадані

Поле	Значення
Продукт	Abitly.org
Тип	Telegram Mini App (Next.js)
Статус	🟢 prod
Власник	@Vladbandurin

Призначення

Telegram Mini App, що запускається з Abitly Telegram bot кнопкою «Open App». Дає інтерактивний UX усередині Telegram (пошук, перегляд ЗВО, чекаут) без переходу в браузер.

Репозиторій та рантайм


Репо	`abitly-org/abitly-telegram-webapp` (`main`)
Стек	Next.js · `@telegram-apps/sdk-react` · Radix UI · TanStack Query/Table · framer-motion · fuse.js (fuzzy search) · React Hook Form · axios
Хостинг	Railway, project `Abitly-Telegram`, service Telegram Webapp (environment `production`)
Деплой	Railway автодеплой з GitHub `main`
Публічний URL	`https://abitly-telegram-webapp-production.up.railway.app`
Попередній deploy	`https://abitly-telegram-web-app-f3jfl.ondigitalocean.app` (DO App Platform — legacy, кандидат на cleanup з CORS-allowlist API)

Залежності

Залежить від: Abitly API (через axios) · Telegram WebApp SDK · Abitly Telegram bot (запускає Mini App через web_app button)
Від нього залежать: —

Env-змінні

Railway variables. Очікувані:

Змінна	Призначення
`NEXT_PUBLIC_API_URL`	base URL Abitly API
`NEXT_PUBLIC_TELEGRAM_*`	можливо ідентифікатор бота / init data validation

Точний список — TODO: (Railway dashboard).

Ключові команди

npm run dev
npm run build && npm run start
npm run lint
npm run format

Деплой та відкат

Railway автодеплой з main. Відкат — mcp__railway__redeploy на попередній SUCCESS.

Логи та моніторинг

Railway built-in logs (через Railway MCP).

Типові проблеми

Mini App не відкривається з бота → перевірити URL у конфігурації web_app button у @BotFather / коді бота
Init data validation падає → перевірити правильність TELEGRAM_BOT_TOKEN (Mini App валідує підпис з secret = SHA256(WebAppData + bot token))
API CORS → перевірити ALLOWED_METHODS у Abitly API