Telegram Mini App

A Telegram mini-app that connects partners for daily accountability, progress tracking, and task confirmation.

Overview

• Backend: Node.js, Express, TypeScript, Prisma, PostgreSQL, Grammy Telegram bot.
• Frontend: React, Vite, TypeScript, Telegram Web App SDK.
• Deployment targets: Render for backend, Vercel for frontend, PostgreSQL on Railway.

Key features

• Secure Telegram Web App authentication
• Daily task confirmation and partner review flows
• Photo proof upload support via S3/R2-compatible storage
• Rate limiting and origin-restricted CORS for safer public deployment
• API documentation via Swagger UI

Getting started

Install dependencies

npm install
npm install --workspace apps/backend
npm install --workspace apps/frontend

Run locally

npm run dev:frontend
npm run dev:backend

Build for production

npm run build

Docs

• Deployment guide
• API reference
• Configuration guide
• Release checklist

Testing

Run backend unit tests:

npm run test:backend

Environment files

• apps/backend/.env.example
• apps/frontend/.env.local.example

Notes

• The backend exposes Swagger UI at /api/docs.
• Production deployment should set CORS_ORIGINS and request limits before going live.