Build your Mini App step by step
0 / 17 done-
Open Mini Agent and start a chat
Mini Agent is the AI builder inside Mini Empire. Connect a bot (paste its BotFather token, or let Mini Empire create one for you), choose the Build with AI card, the recommended one, and finish with Start building with AI. You land in an empty chat that asks what you are building. Mini Agent also has its own bot in Telegram, with the same bots, chats and credits. New accounts start with 100 free AI credits.
Where: Mini Empire → My Bots → Chat Bots → New bot → Build with AI9:41BBean Club@beanclub_demo_botNew chat✨Mini AgentWhat are we building?
I'm Mini Agent, your bot-building assistant. Tell me in your words: I build the blocks, test them in a simulator and leave a draft for you to review and publish.
Build a referral bot with a daily bonus of 0.001 and referral rewards in 2 levelsAdd a /help command that explains how the bot worksAsk new users to join @mychannel before they can claim the bonusMake the bonus 0.0005 every hour instead of every 5 minutesPrefer your own AI?Build this bot from Claude Code, Cursor or any AI that speaks MCP.Your bot's blocks and texts are sent to the AI provider; when you ask it to fix the live bot, also its run journal (keys hidden). The AI saves drafts only.Describe the bot or the change you want…⚡ Auto·🪙 100 credits·Use your own AIThe empty chat. Your credits show under the message box.
-
Ask for one small thing, and only that
This is the whole method in one sentence: ask for ONE specific change, check it live, fix it if needed, then move on. Do not describe the finished product. Start with the smallest slice that already looks like an app, such as “a home screen for my coffee shop with a loyalty card of 10 empty stamp slots”. Small requests come back faster, are easy to check and spend fewer credits.
Where: Mini Agent → message boxIf you catch yourself typing “and also…”, stop. That second idea is your next message.
9:41BBean Club@beanclub_demo_botNew chat✨Mini AgentWhat are we building?
I'm Mini Agent, your bot-building assistant. Tell me in your words: I build the blocks, test them in a simulator and leave a draft for you to review and publish.
Build a referral bot with a daily bonus of 0.001 and referral rewards in 2 levelsAdd a /help command that explains how the bot worksAsk new users to join @mychannel before they can claim the bonusMake the bonus 0.0005 every hour instead of every 5 minutesPrefer your own AI?Build this bot from Claude Code, Cursor or any AI that speaks MCP.Your bot's blocks and texts are sent to the AI provider; when you ask it to fix the live bot, also its run journal (keys hidden). The AI saves drafts only.Make a home screen for my coffee shop: a loyalty card with 10 empty stamp slots.⚡ Auto·🪙 100 credits·Use your own AIOne screen, one idea. Tap the arrow to send.
-
Give every task its own chat
Each bot can have many chats, and each chat is a separate conversation with the AI. Use one per task: the look of the home screen, the prizes admin, the texts. A short, focused chat keeps the AI from mixing things up. When a chat gets long, Mini Agent itself suggests a new one: it is cheaper and more accurate, and it sees the app exactly as it is now. Tap + at the end of the tabs, or the pen icon at the top.
Where: Mini Agent → + (New chat)9:41BBean Club@beanclub_demo_bot·changes not publishedHome screen✕Prizes admin✕+The AI made changes your users don't see yet.PublishMake the stamp circles bigger.Thought for 8sDone in the draft: the stamps are bigger and the card still holds 10. Press Publish to see it in your bot.
Long chat. For a new task, a new chat is cheaper and more accurate: it sees the bot as it is now.New chat✕Describe the bot or the change you want…⚡ Auto·🪙 100 credits·Use your own AITap + for a new chat, or New chat in the banner.
-
Show it how the app should look
Build the look first and the function later. If you can picture the app, make a few screens with another AI: ask ChatGPT or Gemini for something like “three phone screens, dark theme, for a coffee-shop loyalty app: home with a stamp card, prizes, profile”. Then tap the paperclip, attach the images and say what to do with them: “Use these as the design. Build only the home screen for now.” Mini Agent reads the pictures and designs from them.
Where: Mini Agent → 📎 Attach filesReferences steer the style; they are not copied pixel for pixel. Expect a close cousin, then fix the differences one at a time.
9:41BBean Club@beanclub_demo_botNew chat✨Mini AgentWhat are we building?
I'm Mini Agent, your bot-building assistant. Tell me in your words: I build the blocks, test them in a simulator and leave a draft for you to review and publish.
Build a referral bot with a daily bonus of 0.001 and referral rewards in 2 levelsAdd a /help command that explains how the bot worksAsk new users to join @mychannel before they can claim the bonusMake the bonus 0.0005 every hour instead of every 5 minutesPrefer your own AI?Build this bot from Claude Code, Cursor or any AI that speaks MCP.Your bot's blocks and texts are sent to the AI provider; when you ask it to fix the live bot, also its run journal (keys hidden). The AI saves drafts only.✕✕✕Use these screens as the design for the home screen. Only build the home screen for now.⚡ Auto·🪙 100 credits·Use your own AIAttach your reference screens, then say what to do with them.
-
Bring your own artwork
Mini Agent draws with vectors and CSS, so icons, shapes, gradients and simple illustrations come out crisp. It cannot paint photographs or realistic 3D art. For that, make the pieces (a stamp icon, a card background, a mascot) in ChatGPT or Gemini and bring them in. Ask for an admin screen with an upload button, such as “Add an admin screen where I can upload the stamp icon and the card background, and use them in the app”, or attach the picture in the chat and ask Mini Agent to use it. Uploaded images are stored by the platform: PNG, JPEG, WebP or GIF, up to 3 MB each.
Where: Mini Agent → admin screen → Upload imageAsk for “realistic” or “photo-like” art and Mini Agent will tell you it cannot. Save the credits and bring the picture.
9:41GraphicsOnly you see thisAdminStamp icon
stamp-bean.pngUsed on every stampReplaceCard background
Upload imagePNG, JPEG, WebP or GIF · up to 3 MB
CardPrizesAdminAn example of an upload screen Mini Agent can build.
-
Open the app and check every change
After each answer, look at the app before asking for more. When the top bar says “changes not published”, a Publish bar appears: while the app has no users yet, publishing early is safe, it is one tap and it costs no credits. Then tap the green ▶ (Open your bot), press the Open button in the chat and look at the app on your phone the way a user will. Something off? Say exactly what: “The stamp circles are too small and too close to the left edge.”
Where: Mini Agent → Publish → ▶ Open your bot9:41BBean Club@beanclub_demo_bot·changes not publishedHome screen✕+The AI made changes your users don't see yet.PublishMake a home screen for my coffee shop: a loyalty card with 10 empty stamp slots.Thought for 14sThe home screen is ready in the draft: a stamp card with 10 slots (6 filled as a preview) and three tabs.
Press Publish to see it in your bot.
Describe the bot or the change you want…⚡ Auto·🪙 100 credits·Use your own AIPublish, then tap the green ▶.
-
Give each part a function, one at a time
With the look settled, bring it to life one screen or one button per message: “Make the Redeem button work. It turns green when the card has 10 stamps and says how many are missing before that.” Describe what the person sees and what should happen; Mini Agent takes care of saving the data behind it. Then repeat the loop: check it in your bot, fix what is off, ask for the next piece.
Where: Mini Agent → message box9:41BBean Club@beanclub_demo_bot·liveHome screen✕+Make the Redeem button work. It turns green when the card has 10 stamps and says how many are missing before that.Thought for 11sThinking…The button needs the stamp count of the person who opens the app, so I will read it from their saved card first…Describe the bot or the change you want…⚡ Auto·🪙 98 · this answer: 1.6·Use your own AIWhile it works you can watch, or open another chat.
-
A big request gets a plan first
Ask for a lot at once, say “build the whole loyalty app”, and Mini Agent does not start spending. It shows a plan card in plain words: what you get, how it looks and one estimate, such as “~70 credits · ~9 min”. Build it starts the work. Keep planning lets you type what to change in the plan. Nothing is built until you choose, and the build stops before it passes its spending cap.
Where: Mini Agent → plan card → Build it9:41BBean Club@beanclub_demo_bot·liveLoyalty app✕+Build the whole loyalty app: the card, prizes, a profile and an admin area.Your build plan is readyBean Club loyalty app
What you get
- A stamp card with 10 slots for every member
- A prizes list members can unlock
- An admin area to manage prizes, only for you
+2 more
How it looks
📱A mini app that opens inside Telegram, made for phones, in light and dark.⏱ ~70 credits · ~9 minBuild itKeep planningQuick questions first: 1
▸ Technical detailsDescribe the bot or the change you want…⚡ Auto·🪙 100 credits·Use your own AIThe figures here are an example: yours will differ.
-
Answer the quick questions, or keep the star
If the plan still has open questions, Build it asks them one per screen, as big cards, with a progress bar on top. Mini Agent has already marked its pick with a star, so if you are not sure, keep it and tap Next. Here it asks how people will use the bot: Mini app (its own screens) is the one for an app with tabs and lists. On the last question the button says Build it.
Where: Plan card → Build it → Quick questions9:41BBean Club@beanclub_demo_bot·liveLoyalty app✕+Build the whole loyalty app: the card, prizes, a profile and an admin area.Your build plan is readyBean Club loyalty app
What you get
- A stamp card with 10 slots for every member
- A prizes list members can unlock
- An admin area to manage prizes, only for you
+2 more
How it looks
📱A mini app that opens inside Telegram, made for phones, in light and dark.⏱ ~70 credits · ~9 minBuild itKeep planningQuick questions first: 1
▸ Technical detailsDescribe the bot or the change you want…⚡ Auto·🪙 100 credits·Use your own AIQuick questions1 of 2How should people use your bot?
This decides how the whole bot is built.
MixedMenu keys for the main sections; buttons under the message for lists, details and confirmations.Keyboard menu everywhereMenu keys at the bottom of the chat on every screen.All inlineButtons under each message, which updates in place.✓Mini app (its own screens)★ RecommendedA real app that opens inside Telegram, with its own screens, tabs and design. Best for lists, profiles and shops.★ marks my pick. Not sure? Just keep it.
CancelNext -
Watch it build, stage by stage
Once you confirm, the plan lives in a floating header with its progress, so you can keep working in other chats. Tap it to open the quest: a ring with the percentage, the stage in plain words (“Designing your screens”, “Bringing it to life”), credits used and minutes left. If it pauses because the spending cap was reached or credits ran out, Continue picks up where it stopped.
Where: Mini Agent → plan header → View9:41BBean Club@beanclub_demo_bot·liveLoyalty app✕+🛠️Bean Club loyalty appBuilding · 1 of 5 stepsViewBuild the whole loyalty app: the card, prizes, a profile and an admin area.Describe the bot or the change you want…⚡ Auto·🪙 100 credits·Use your own AIYour build plan#12 · Building20% Step 2 of 5Designing your screens
Bean Club loyalty app
- ✓Preparing your data
- 🎨Designing your screens · Home
- 🔌Bringing it to life
- 📱Adding the menu button
- 🏁Final quality check
▸ Technical detailsCancel planPause -
Build an admin panel for what you manage
For everything you will run, ask for its own admin screen in the same breath: “Add an admin screen to manage the prizes: add, edit and remove them. Only I should see it.” You change prizes, prices and texts from your phone instead of asking the AI each time, which is faster and safer, and members never see that area. Build one admin screen per message, exactly like the rest.
Where: Mini Agent → message box9:41Manage prizesOnly you see thisAdminFree coffee10 stampsPastry of the day15 stampsBean bag 250 g30 stampsAdd prizeCardPrizesAdminOnly the owner sees the Admin tab.
-
Work in several chats at the same time
As the app grows, give every task its own chat and let them work in parallel: one polishing the card, another building the prizes admin, a third rewriting the texts. A spinner on a tab means that chat is working; a dot means it finished while you were looking elsewhere, and the app tells you when it does. Up to three chats work at once, and chats that touch the same part of the app wait for their turn, so give each a different area.
Where: Mini Agent → chat tabs9:41BBean Club@beanclub_demo_bot·changes not publishedCard look✕Prizes✕Texts✕+The AI made changes your users don't see yet.PublishGive the stamp card a warmer coffee-brown look.Thought for 6sThinking…Describe the bot or the change you want…⚡ Auto·🪙 100 credits·Use your own AIA spinner means working. A dot means finished.
-
Test, fix, repeat: show the problem
Testing is part of every step, not a chore for the end. When something looks wrong, or a flow breaks, do not write a long description. Take a screenshot of the app (or of the bot’s chat), tap the paperclip, attach it and add one line of what you expected: “The Buy button does nothing here. It should open the payment.” Mini Agent sees exactly what you see, so it fixes the right thing faster, and usually for fewer credits, than a long explanation would. Then open the app and check again.
Where: Mini Agent → 📎 Attach filesCircle or point at the problem in the screenshot if you can, and keep to one problem per message.
9:41BBean Club@beanclub_demo_bot·changes not publishedShop✕+The AI made changes your users don't see yet.PublishShopBean bag 250 gFresh roastBuyThe Buy button does nothing here. It should open the payment.Looked at your photosThought for 7sFound it: the Buy button was not connected to the payment. In the draft it now opens the payment for the bean bag.
Press Publish and tap Buy to try it.
Describe the bot or the change you want…⚡ Auto·🪙 100 credits·Use your own AIA screenshot plus one line of what you expected.
-
Undo for free when a fix goes wrong
If a change makes things worse, the clock icon in the top bar opens your draft: Undo last change, Publish, or go back to any earlier version. None of those buttons uses the AI, so none costs credits, and restoring a version never deletes the others. That safety net is what makes small, fast experiments cheap.
Where: Mini Agent → clock icon9:41BBean Club@beanclub_demo_bot·changes not publishedShop✕+The AI made changes your users don't see yet.PublishThe Buy button does nothing here. It should open the payment.Describe the bot or the change you want…⚡ Auto·🪙 100 credits·Use your own AIYour bot's draftDraft v7 · live v6These buttons don't use the AI: they cost no credits.
Undo last changePublishClear the botVersionsv7draft13 blocks · Oct 08, 02:32 PMv6live12 blocks · Oct 08, 01:50 PMRestorev512 blocks · Oct 08, 01:14 PMRestore -
Publish with one tap
When the app does what you want, tap Publish. A centered window walks through the checks: the bot is reviewed for problems, the mini app is opened and tested on a phone-sized screen, and only then does it go live. If a check finds a problem, a list explains it and Ask the AI to fix it sends it straight to Mini Agent. Nothing reaches your users until every check passes.
Where: Mini Agent → Publish9:41BBean Club@beanclub_demo_bot·changes not publishedShop✕+The Buy button does nothing here. It should open the payment.Describe the bot or the change you want…⚡ Auto·🪙 100 credits·Use your own AI🚀Publishing your bot…
- Checking the bot for problems
- Testing your mini app on a phone
- Going live for your users
-
You are live
The window turns into a celebration: “You are live! Version 7 is now what your users get.” Your bot’s /start now carries an Open button that launches the mini app. Tap Open your bot and run through it once more, ideally from a second Telegram account and in both light and dark mode.
Where: Mini Agent → Open your bot9:41BBean Club@beanclub_demo_bot·liveShop✕+The Buy button does nothing here. It should open the payment.Describe the bot or the change you want…⚡ Auto·🪙 100 credits·Use your own AI🎉You are live!
Version 7 is now what your users get.
DoneOpen your bot -
Open it like a member would, then keep the loop going
This is what your users see: the home screen you designed, with data that is theirs. From here the method does not change. New idea? New chat, one small change, check it in your bot, publish. The admin screens you built let you run the app day to day, and every addition goes through the same loop: ask, check, fix, next.
Where: Your bot → Open9:41Bean ClubHi, AlexAYour stamp card
6 of 10 stamps4 more for a free coffeeRedeem free coffeeCardPrizesProfileWhat a member sees. Demo data.
Your first Mini App is live
You built it the way the method says: small, checked, one chat per task, fixed by showing. Now it needs people. Next, learn how to find your first users and what to measure.
Next guide Get your first users: promote your Mini App →Open Mini Agent, the AI builder inside Mini Empire, and build the app in small steps: ask for ONE change, look at it in your bot, fix it, then ask for the next. Design the look first (reference screens from ChatGPT or Gemini help), then give each screen its job, add an admin panel for whatever you manage, and publish with one tap. Keep one chat per task, and when something breaks, attach a screenshot and one line of what you expected. Small asks keep the AI focused and the credits low.
Describe the app. Check it. Publish it.
Mini Agent is the AI builder inside Mini Empire. You tell it what you want in your own words; it builds the screens and the logic behind them, tests the app on a phone-sized screen and leaves a draft that goes live with one tap.
Built in small steps
Ask for one change, look at it in your bot, fix what is off, then ask for the next. Short chats keep the cost and the confusion low.
Looks first, then function
Attach reference screens from ChatGPT or Gemini, design the look, then give each screen its job. Add admin screens for whatever you manage.
Fix by showing
Attach a screenshot of what went wrong and one line of what you expected. Undo the last change or restore any version without spending credits.
100free credits to start
1 tapto publish
0lines of code
Why small steps beat one big prompt
An AI builder is at its best when the next move is obvious. Ask for a single screen and it has everything it needs: you can read the result in seconds, tell whether it is right and say precisely what to change. Ask for a whole product in one message and you get a large, tangled draft where the first mistake hides behind ten correct things.
Cost follows the same logic. Every answer spends credits, and a long chat that keeps growing makes each answer heavier. Short, single-purpose chats and one-change messages keep both the bill and the confusion small. Mini Agent even nudges you: in a long chat it suggests a new one, because a fresh chat is cheaper and more accurate and still sees the app as it is now.
What Mini Agent builds, and what to bring yourself
Mini Agent reads the images you attach, so a reference screen, a sketch or a screenshot is often the fastest way to say “like this” or “not like this”. It cannot paint pictures of its own, which is why artwork enters the app through an upload screen or the paperclip.
| Mini Agent does it | Bring it yourself |
|---|---|
| Screens, layout, colors, light and dark themes | Photographs and realistic or 3D artwork |
| Icons, shapes, gradients and simple vector illustrations | Brand assets: logo, mascot, character art |
| The data behind the app and the buttons that use it | Your texts, prices and prize rules: decisions only you can make |
| Admin screens that only you can see | Reference screens from ChatGPT or Gemini if you want a specific look |
| Testing the app on a phone-sized screen before it goes live | A second Telegram account to try it as a member |
Prompts that work: small, specific, one at a time
A good message names one thing the person will see or do. You do not need technical words; you need the result you expect. When the result is wrong, the best correction is a picture.
| Instead of… | Ask for… | Why it works |
|---|---|---|
| Build my whole coffee app with prizes, QR codes, push messages and an admin | A home screen with a loyalty card of 10 stamp slots | One screen to judge; the next message builds on it |
| Make it look better | Make the stamp circles bigger and give the card more space around them | The AI changes what you named and nothing else |
| Add a login | Greet the person by first name at the top | Telegram already tells the app who is opening it, so no login is needed |
| The Buy button is broken | A screenshot of the screen plus: “The Buy button does nothing here. It should open the payment.” | The AI sees what you see and the outcome you expected |
| Add prizes | A Prizes tab listing each prize and the stamps it needs, then its admin, then the Redeem button | Three messages, three checks |
The habit that saves the most credits: show, do not describe
Screenshots are not only for the design. The moment something looks wrong, a flow stops half way or the bot answers oddly, take a screenshot of the app or of the bot’s chat, attach it with the paperclip and add one line: what you expected. Mini Agent sees exactly what you see, so it skips the guessing that a long description invites.
Two small rules make it work. Keep to one problem per screenshot, and say the expected result rather than the technical cause. “It should open the payment” is better than a theory about why it does not.
Credits: how to keep the cost low
- Ask for one change per message: a small request is a small answer.
- Use one chat per task, and start a new chat when Mini Agent suggests it.
- Read the estimate on a plan card before you tap Build it, and keep the spending cap it proposes.
- Check each change in your bot before asking for the next, so a mistake costs one answer rather than ten.
- Attach a screenshot when something breaks instead of writing a long explanation.
- Use Undo last change, Publish and version restore freely: they do not use the AI, so they cost no credits.
- New accounts start with 100 free credits, so you can try the method before you buy any.
Mistakes that make AI-built apps feel unfinished
- Describing the entire product in the first message.
- Using one endless chat for everything.
- Skipping the look and asking for features first, then redesigning around them.
- Asking for “realistic” images instead of bringing your own artwork.
- Forgetting the admin side, so every price or text change needs the AI again.
- Describing a bug in a paragraph instead of attaching a screenshot.
- Publishing to real users without opening the app once on a phone.
- Letting two chats edit the same screen at the same time.
A last check before you invite anyone
- Open the app from a second Telegram account, not only the owner account.
- Confirm the admin screens are hidden from that second account.
- Read every text as a stranger would and replace placeholders with real wording.
- Try a small phone screen and both light and dark themes.
- Complete the main action from start to finish.
- Close Telegram, reopen the app and confirm the data is still there.
Common questions
Can I build a Telegram Mini App with AI without knowing how to code?
Yes. With Mini Agent you describe the app in your own words and it writes, tests and saves the app for you. You still make the decisions: what each screen shows, what the buttons do and what the texts say.
How many credits does a Mini App cost?
It depends on how big the app is and how many changes you make, so there is no fixed price. New accounts start with 100 free credits, a plan card shows an estimate before any big job, and small one-change requests spend the least.
Do I need a BotFather token?
Not necessarily. You can paste the token of a bot you created with BotFather, or let Mini Empire create a new bot for you. A bot created that way shows a note on its profile saying it was created and managed by the platform.
Can I use images from ChatGPT or Gemini?
Yes. Attach reference screens in the chat so Mini Agent can design from them, and bring generated artwork in through an admin upload screen or by attaching it (PNG, JPEG, WebP or GIF, up to 3 MB each for uploads). Mini Agent draws vector and CSS graphics but cannot create photographs.
How do I tell Mini Agent that something is broken?
Take a screenshot of the app or of the bot’s chat, attach it with the paperclip and add one line of what you expected, for example “The Buy button does nothing here. It should open the payment.” It sees what you see and fixes the right thing.
What if the AI breaks something?
Open the clock icon in the top bar: Undo last change reverts the latest edit and every earlier version can be restored. Neither uses the AI or costs credits, and your users keep seeing the published version until you publish again.
Can I add an admin panel to my AI-built Mini App?
Yes. Ask for an admin screen for the thing you manage, such as prizes, prices or texts. It is shown only to you as the owner and to admins you set; regular users do not see it.
How is this different from Mini Empire’s ready-made Mini App templates?
The ready-made templates are prepared products, such as airdrops, mining and games, that you configure. Mini Agent builds a custom app from your description. Both live in the same Mini Empire account, so you can use either for different projects.
Sources and further reading
Technical and product claims were checked against these primary sources.