Payment protectionDetails
- Revisions within the package are free.
- If you do not respond within 3 days of delivery, the work is accepted automatically.
The money is reserved when you pay and released only once you accept the work.
Example result
Technical specification: booking website for a yoga studio
1. Project goals
- Let clients see the timetable and book a class in under one minute, from a phone.
- Sell class passes and memberships online.
- Cut the time staff spend on bookings from about 10 hours a week to under 2.
Success measures (3 months after launch): 70% of bookings made online; no-shows below 10%.
2. Users
| Role | What they need |
|---|---|
| Visitor | See classes, prices and teachers; buy a first-class trial |
| Client | Book and cancel classes, see remaining passes, join a waitlist |
| Teacher | See their own classes and the list of booked clients |
| Admin | Manage timetable, prices, passes, teachers and refunds |
3. Pages and screens
- Home: next classes today, trial offer, studio address.
- Timetable: week view, filters by class type, level, teacher and room.
- Class page: description, teacher, length, places left, Book button.
- Prices: single class, 5- and 10-class passes, monthly membership.
- Teachers: list and individual profiles.
- Account: upcoming bookings, history, passes, payment methods.
- Admin panel: timetable editor, client list, sales report.
4. Key features
4.1 Booking
- A client can book if they have a valid pass or pay for a single class.
- Class capacity is set per room (Room A: 18, Room B: 10).
- When a class is full, the client can join a waitlist; if a place opens, the first person in line gets it and receives an email and text message.
4.2 Cancellation
- Free cancellation up to 12 hours before class; the pass credit returns.
- Later cancellation or a no-show uses up the credit.
4.3 Payments
- Card payments through a payment provider chosen by the studio.
- Passes expire: 5-class after 2 months, 10-class after 3 months.
4.4 Notifications
- Booking confirmation, reminder 3 hours before class, waitlist updates.
5. Non-functional requirements
- Mobile-first; pages load in under 2 seconds on 4G.
- Works in the two latest versions of major browsers.
- Personal data stored in line with local data protection law.
6. Open questions
| # | Question | Who decides |
|---|---|---|
| 1 | Do teachers mark attendance in the app, or does the front desk? | Studio owner |
| 2 | Is a 2-week trial pass needed in addition to a single trial class? | Studio owner |
| 3 | Should the timetable be embedded on the current website or replace it? | Owner + developer |
| 4 | Which payment provider and text-message service are preferred? | Owner |
Client: Lotus Lane Yoga, a studio with 2 rooms, 9 teachers and about 60 classes a week. Today bookings go through direct messages and a paper sign-up sheet. Standard package: specification up to 10 pages. Excerpt below.
The client and all details are made up.
About this service
A Telegram Mini App is a web app that opens inside Telegram, and that changes the rules: users are logged in through their Telegram account, screens must fit the chat window on a phone and follow the Telegram theme, and payments for digital goods go through Telegram Stars. We write a specification that covers how the app is launched, every screen, the main button and back button behavior, sign-in, payments, notifications and the admin side. Developers who know the Telegram platform can quote and build from it.
What is included
- What you getA Mini App specification with goals, launch points, screen list and contents, sign-in and payment flows, notifications, admin features and open questions, as formatted text; any time or cost figures are rough guidance, not a quote.
- Launch pointsMenu button, links, buttons in chats and channels
- ScreensEach screen sized for the Telegram window
- Telegram controlsMain button, back button, theme colors
- Sign-in and paymentsTelegram account login, Stars or card payments
- Admin sideOrders, content and user management
How it works
- 1BriefYou describe the app and audience
- 2PlanningWe map launch, screens and payments
- 3SpecYou get a specification for developers
What we need from you
What the Mini App does and for whom, where users will open it from, what they can buy or book, examples of Mini Apps you like and whether you already have a Telegram channel or community.
We will ask you:
- What should the Mini App do?
- Where will users open it from?
- Will users pay inside the app?
- Do you need an admin panel, and who will use it?
Compare packages
| Packages | BasicOne-page brief$19 | StandardSpec up to 10 pages$39 | PremiumFull spec up to 20 pages$79 |
|---|---|---|---|
| Deadline | 1 day | 3 days | 5 days |
| Revisions | 1 | 2 | 3 |
| Length | 1 page | up to 10 pages | up to 20 pages |
| Payment flows | No | Yes | Yes |
| User stories and acceptance criteria | No | No | Yes |
| Order Basic | Order Standard | Order Premium |
Payment protection
You pay when you order, but the money is released only for accepted work.
- Fixed priceThe package price does not change after you pay.
- The money is reservedWhen you pay, the amount is only reserved. It is released to the service once you accept the work.
- Checked before deliveryEvery result goes through a quality check before it reaches you, and you see it on the order page before accepting it.
- Free revisionsAsk for changes within your brief as many times as the package allows.
- Acceptance after 3 daysIf within 3 days of delivery you neither accept the work nor ask for changes, it is accepted automatically. If you write in the order chat after delivery, the order waits; once we answer, we may start the 3 days again and will say so in the chat.
- Redo or a full refundIf the result does not match your brief and the revisions did not fix it, or the work takes more than twice its deadline, write in the order chat: we will redo the work or refund the payment in full.
Questions and answers
Do payments have to go through Telegram Stars?
For digital goods and services inside Telegram, Stars are the required method under current platform rules; physical goods can use card payment providers. Platform rules change, so the spec flags this for your developer to confirm.
Will the app also work in a normal browser?
It can, if you want it to. The spec states which features rely on Telegram and what happens when the app is opened outside it.
Will you build the Mini App?
No, this service is the specification only.