App Builder: FAQs & Troubleshooting
Answers to common App Builder questions, and fixes for stalled builds, preview errors, failed tests, and failed publishes.
This page answers common questions about building, importing, versioning, and publishing apps. Use the troubleshooting entries when a build stalls, the preview errors, tests fail, or a publish doesn't go through.
FAQs
Building
Who can build and publish apps?
Every standard role can view apps. Building, importing, exporting, publishing, sharing, versions, Git, custom domains, and attaching agents need Developer, Account Admin, or Organisation Admin. See Roles.
What's the difference between Plan Mode and Build Mode?
Build Mode, the default, builds on every prompt. Plan Mode lets you talk through the requirements first, and nothing is built until you switch back. Publish is unavailable in Plan Mode. See Plan.
Which kinds of app can I build?
Web App, the default, with pages, data, and a backend; Website, for landing pages and marketing sites; and Mobile (Beta), a native app for Android and iOS. See Create a new app from a prompt.
How long can one request run?
Up to 45 minutes. A longer request is stopped, and the work done so far is saved. See Describe and build.
Can I edit the generated code myself?
Yes. In Code, select a file, select Edit, make your changes, and select Save. Saving an edit creates a new version. See Code.
Does building an app use credits?
Yes. The workspace's Credits meter shows what the app has consumed: credits used, cost, and when the figure was last synced. See Credits.
Importing, versions, and export
What can I import?
A ZIP package or project up to 500 MB, a GitHub repository, or a GitLab project. A Qore Platform package is restored as it was; anything else, such as a Git repository or a project from another builder, is converted into a Platform app. See Import an existing app.
What's the difference between View Version and Revert to Version?
View Version loads an older version temporarily; your current version stays unchanged. Revert to Version reverts the app to it. Published marks the version users see. See Versions and publishing.
Where does an app export go?
To your email. The package isn't downloaded in the browser; Qore shows Export started. You will receive an email when it is ready. Chat history is left out unless you tick Include chat history in package. See Export.
Publishing
Does an app need a database to publish?
Yes. The database is Required on the publish checklist; without one, the app can't be published. See Connect the database.
Can I change where each service runs after publishing?
Yes. Republishing redeploys the affected services. See Choose where each service runs.
What happens when I publish a new version?
Publish shows the last published version, its date, and the live URL. Review the checklist and select Publish Changes; the platform deploys the current version and updates the live URL. See Publish a new version.
Troubleshooting
Building
My app started building before I finished planning
Build Mode builds on every prompt. Switch to Plan Mode first. See Plan.
The build seems stuck
Check the build conversation for an Agent is waiting for your input step, such as choosing a provider. Make a choice, or select Skip. See Create an app.
"This request ran too long and was stopped"
A single request can run for up to 45 minutes. The work done so far is saved. Send a follow-up to continue, or split the request into smaller steps. See Describe and build.
"We are currently experiencing an issue with code generation"
Code generation failed. Try again, or switch to a different model. See Describe and build.
The preview shows an error
A bar at the bottom of the build conversation shows the error, for example UNHANDLED_REJECTION, with Fix with AI. Select it to send the error type and message to the build agent, which fixes the app and rebuilds the preview. See Fix errors.
Fix with AI is greyed out in Security
Fix with AI is already working. Wait for it to finish. See Security Scans.
Proceed is greyed out in Attach Agent(s)
Tick at least one agent. See Integrate an agent.
The Export icon is disabled or missing
Exporting needs the Export App capability. The icon isn't shown while the app is still in its initial plan. See Export.
Tests and publishing
A build failed its tests
Open View Report to see which suites and tests failed. Fix the app in the workspace, by describing the fix or forwarding a failing test to the build agent, then rebuild; the new build gets its own test run. See If a build fails its tests.
The checklist shows the database as Not Configured
Select Connect beside the database, choose a database, then create a schema or connect an existing one. See Connect the database.
"Publishing Failed"
Select Try Again, or Fix with AI to send the failure to the build agent. View Error Details opens the deploy log, with numbered build steps and the underlying error. See Resolve a failed publish.
Import from GitLab shows no projects
GitLab needs an account connection first. Select Connect GitLab, authorize Qore, and return to the tab. See Import from GitLab.
Related
Create an app: every App Builder task
Maintained by Abhishek Paul
AI-assisted, human-approved
Last updated
Was this helpful?