Agency workspace for Telegram token campaigns: many branded Mini App campaigns from one self-hosted install, bot-filtered analytics and white-label client reports.

What it does

• Many branded campaigns from one self-hosted install, one Telegram bot each
• Player Mini App: tap and farm, upgrades, daily streak, quests, two-tier referrals, squads, daily puzzle, achievements
• Seasons with a cosmetic-only Telegram Stars season pass and live events
• Stars cosmetics shop (never points, energy or allocation) and Adsgram rewarded ads with a server-side callback
• Explainable anti-bot: 8 automatic signals with evidence, review queue, appeals, public Fairness Center
• Airdrop: snapshot, fair multipliers, Merkle root frozen at publish, TON distributor deployed and funded from your own wallet, player claim
• Operator admin: overview analytics, cohorts, funnel, tracked links, sponsors and sponsored quests, broadcasts, revenue
• White-label read-only client report links

You need

• Node.js 22+ (package.json engines ">=22")
• pnpm 10 (packageManager pnpm@10.33.2)
• PostgreSQL 16 (docker-compose.yml image postgres:16-alpine)
• A VPS with Docker + docker-compose for the API and Postgres, behind https (TRUST_PROXY=true behind a reverse proxy)
• Static hosting over https for the Mini App and the admin; admin on the same site as the API (SameSite=Lax cookie, README