🚀 MiniBooker — Enterprise-Grade Telegram Mini App for Booking (White-Label SaaS)

Turn Telegram into your booking engine.
MiniBooker is a premium, production-ready white-label template for building a fully automated service booking system directly inside Telegram. Stop paying monthly subscriptions for basic booking widgets and own your infrastructure.

Whether you are a developer looking to sell a SaaS to local businesses, an agency building a custom solution, or a barbershop owner wanting total control — MiniBooker is the ultimate foundation.

💡 Why MiniBooker? (The Problem We Solve)

Most booking systems are clunky web pages that force customers to leave the app, register with email, and confirm phone numbers. MiniBooker solves this. Your clients open Telegram, click your bot, and book a service in 3 clicks — with zero friction.

🔥 Killer Features (Out of the Box)

1. 📱 Seamless Telegram Mini App: Native-like experience inside Telegram. Clients pick a service, date, and time instantly. No app downloads required.

2. 🌍 True Multi-Language & Multi-Currency: Fully localized (RU/EN/ES) both for the client and the admin panel. Supports USD, EUR, GBP, and RUB per business.

3. 🛡 Enterprise-Grade Security: Built with strict PostgreSQL Row-Level Security (RLS). We validate Telegram initData via JWT to ensure 100% protection against session forgery.

4. 🚫 Zero Double-Bookings: Powered by a PostgreSQL exclusion constraint. Even if 100 clients click "Book" at the exact same millisecond, the database guarantees only one will get the slot.

5. ⚙️ Smart Scheduling & Resources: Manage multiple branches, assign staff to specific services (qualifications), and tie physical resources (chairs, rooms, equipment) to locations. The system automatically inherits schedules and prevents conflicts.

6. 🔔 Instant Telegram Notifications: Using the Grammy framework, the business owner gets an instant push notification for every new booking. Delivery failures are logged but don't break the booking process.

7. 👥 Team Management: Invite staff via one-time secure links with automatic branch assignment and role protection.

🛠 Tech Stack (Built for Scale)

No jQuery spaghetti. This is modern, type-safe code:

• Framework: Next.js (App Router) & React

• Language: TypeScript

• API Layer: tRPC with Zod validation

• Database: PostgreSQL (Supabase) & Drizzle ORM

• Styling: Tailwind CSS

• Bot Framework: Grammy

• Testing: Vitest for critical domain logic

📦 What is Included in the ZIP?

You are not just getting code; you are getting a complete deployment kit:

• ✅ Full Source Code (clean, feature-based architecture).

• ✅ README.md — Detailed, step-by-step setup for Supabase, BotFather, and Vercel.

• ✅ QUICK_START.md — Get your system running in exactly 5 minutes.

• ✅ supabase_setup.sql — A single SQL script to deploy the entire database schema, including RLS policies and triggers.

• ✅ .env.example — Clear variables for safe and quick configuration.

🎯 Who is this for?

• Developers & Freelancers: Rebrand it, sell it to your local salon, and charge a premium.

• Agencies: Use it as a robust boilerplate for client projects.

• Business Owners: Own your code, host it on your server, and stop paying SaaS fees forever.

Stop building from scratch. Launch your Telegram booking platform today.