Troubleshooting & FAQs
Common issues you might run into when using Buildprint agents, and how to resolve them.
Buildprint didn't build what I wanted
If the agent made changes that don't match what you had in mind, the fastest fix is to start over with a clearer prompt:
Restore to your last savepoint to undo the agent's changes.
Think about what was unclear — was the prompt too vague? Did it leave room for interpretation?
Start a new conversation with a more specific prompt that describes exactly what you want.
Trying to get the agent to fix its own mistakes in the same conversation usually leads to more issues. A fresh start with a better prompt is almost always more effective.
Buildprint created issues in the editor
Buildprint cannot see Bubble's issue checker, so it may introduce errors it doesn't know about. For small, isolated issues, the easiest fix is to correct them yourself in the Bubble editor and ask Buildprint to resync so it can view your changes.
If the issues are significant and wide-ranging — affecting multiple workflows or data types — it's better to restore to a savepoint and start again with a narrower prompt. Attempting to patch many scattered issues usually takes longer than just redoing the work cleanly.
Buildprint, like any other human developer, is not perfect. Issues will be created sometimes, which is why it's important to review its work carefully.
Agent can't access MCP tools / use Buildprint / can't connect
We're aware of a bug that stops some Claude sessions connecting to the Buildprint server to take actions on your Bubble app. In the meantime, you can simply start a new conversation and try again.
Buildprint can't see my changes
Buildprint can only see changes it makes. If you make changes directly in the Bubble editor on the same branch the agent is working on, it won't be aware of them.
To fix this, ask the agent to resync. This tells it to refresh its view of the app so it can see your manual changes. Without resyncing, the agent may overwrite your work or make decisions based on an outdated view of the app.
Buildprint stops running unexpectedly
First, retry once by sending a follow up message. If it persistently fails to respond to queries, start a new conversation as the conversation may be corrupted or there may be an issue with the upstream model provider e.g OpenAI/Anthropic. You can optionally copy the conversation history to bring across your context.
Buildprint is slow
Buildprint is not intended to be something you sit around and watch. Buildprint is designed to take long enough that it gets it right, and you can go and get a coffee or go for a walk.
Some models are slower than others. Gemini models are particularly slow when reasoning is enabled.
We're actively working on speeding up how fast Buildprint can explore and edit your app, particularly for large apps, but are generally prioritising quality rather than speed for now.
Buildprint lets you work on multiple tasks at once - embrace that and you'll be able to significantly improve your Bubble development output.
In addition, Buildprint will sometimes be slower than doing it manually. If it implements something, and you need to make one small change - just do it yourself! That's the power of Bubble, and it is an important skill to know when to update things yourself, and when to delegate to Buildprint.
Usage limit reached
If you see a usage limit error or are hitting rate limits, this is coming from your AI provider (ChatGPT or Claude), not from Buildprint. Your provider's rate limits apply to all usage across their platform, not just Buildprint.
To resolve this:
Upgrade your plan with your AI provider to get higher rate limits.
Start a new conversation after upgrading. It may take some time for the new limits to take effect due to caching from the providers.
Wait for the rate limit window to reset if you don't want to upgrade.
Buildprint requires smart models and plenty of tokens. Anthropic's plans in particular have low rate limits. Do not expect to be able to use Buildprint all day, every day, on their $20/mo plan.
The best value and recommended
plans are the ChatGPT $20/mo and $200/mo plans.
I don't see Buildprint's changes in the editor
First, make sure you're checking the same branch as Buildprint's edits. Some edits may require refreshing the Bubble editor to be visible (e.g creating pages).
Buildprint refuses to make the changes
If editing mode is enabled and Buildprint says it is unable to make the changes, this is likely our issue checker kicking in. We automatically validate any changes for validity on your Bubble app, to decrease the likelihood of unusual issues slipping in. Our issue checker might be returning a false positive which stops the edit. Here, you can ask Buildprint what it wants to do and then execute that specific change yourself. To report the issue to us, ask Buildprint to submit a bug report and we'll be able to check it out.
Do I need to reconnect Buildprint when migrating to a dedicated server?
If you're migrating from a shared cluster Bubble app to a dedicated server, it is possible for us to migrate your Buildprint connection without losing your project data and logs. Please contact us to handle this for you, with your current app details, and we can make this migration for you. Alternatively (but not recommended), you can create a new Buildprint project for your new dedicated app and delete your old Buildprint project.
How can I rename my conversation?
Hover the conversation in the sidebar, and click the three dots on the hover card, and click "Rename". Only conversation owners can rename them.
Does Buildprint support native mobile?
We're rolling out support for native mobile. For now, Buildprint should be mostly accurate with its native mobile work, but you should monitor it. It may need more guidance than on web apps.
How can I view invoices for purchases?
Navigate to Workspace Settings by clicking the workspace switcher in the top left of the sidebar, hovering your workspace, and clicking Settings.
Switch to the Billing tab.
Click Manage billing.
You can download invoices / update payment method here.