Troubleshooting
Most LaunchPulse issues can be fixed by checking the build state, preview, credits, subscription, connected services, or project configuration. Use this page when something does not work as expected while building, testing, deploying, publishing, or managing your LaunchPulse project.The fastest way to debug a LaunchPulse project is to describe the exact issue inside the project chat, include what you expected to happen, and ask LaunchPulse to inspect the relevant area.
Start here
Before going deep, try these quick checks.Refresh the preview
Refresh the live preview after a build finishes. Some changes may not appear until the preview reloads.
Check the latest task
Look at the latest agent message and confirm whether the task completed, failed, or needs a follow-up.
Test the main flow
Try the exact user journey that is broken, such as sign-up, upload, checkout, publish, or save.
Check credits
If AI actions stop working, review your credit balance and plan.
Check your plan
Deployment, custom domains, code download, and some shipping features require a paid subscription.
Ask for a focused fix
Instead of saying “fix everything,” describe one broken flow and ask LaunchPulse to repair it.
Quick diagnosis table
| Problem | First thing to check |
|---|---|
| App changes are not showing | Refresh the preview and confirm the latest task completed |
| App looks broken | Ask LaunchPulse to inspect layout, console issues, and responsive behavior |
| Login does not work | Check Authentication, users, redirects, and test credentials |
| Uploaded files disappear | Check Storage and whether files are connected to database records |
| Data disappears after refresh | Check Database persistence |
| Payments are not working | Check whether the app is web or mobile, then use Stripe or RevenueCat correctly |
| Cannot deploy | Check subscription status and deployment requirements |
| Cannot download code | Check subscription status |
| Custom domain does not work | Check paid plan, DNS setup, and domain configuration |
| Mobile publishing fails | Check App Store / Play Store setup, credentials, package name, and checklist |
| AI actions stop working | Check credits, add-ons, and plan limits |
| API key fails | Check scopes, expiration, and whether the key was copied correctly |
App changes are not showing
Sometimes the app has been updated, but the preview is still showing an older version. Try this first:Check the latest agent message
Confirm that LaunchPulse says the task is complete or the preview has been updated.
Check the correct project
Make sure you are looking at the same project you asked LaunchPulse to update.
The app looks broken or unfinished
If a page feels empty, visually weak, or unfinished, ask for a focused UI improvement rather than a general rewrite. Use this prompt:The agent misunderstood the task
This usually happens when the prompt is too broad or asks for too many changes at once. Instead of asking LaunchPulse to “update everything,” break the work into phases.| Weak prompt | Better prompt |
|---|---|
| “Make the app better” | “Improve the dashboard layout with summary cards, table filters, and a clearer empty state.” |
| “Fix the mobile app” | “Fix the character selection screen so users can choose a character and start a battle.” |
| “Add payments” | “Add Stripe checkout for the Pro plan and lock premium analytics for free users.” |
| “Add storage” | “Let users upload profile avatars and save the image URL to the user profile record.” |
Login or authentication is not working
Authentication issues usually come from missing users, broken redirects, incomplete auth setup, or test credentials not matching the app state. Check:- sign-up flow
- login flow
- logout flow
- protected pages
- redirect after login
- user profile creation
- session persistence after refresh
- test user credentials
Storage uploads are not working
Use Storage when your app needs files, images, documents, avatars, screenshots, PDFs, or media. Common issues:- file uploads fail
- uploaded file does not appear in the app
- file disappears after refresh
- avatar does not update
- uploaded file is not linked to the right user or record
- file size is too large
- missing upload error state
Database data disappears after refresh
If data disappears after refreshing the app, it may only be stored in local state instead of the Database. This often affects:- tasks
- users
- profiles
- products
- bookings
- messages
- goals
- game progress
- AI results
- saved outputs
- uploaded file references
Payments are not working
LaunchPulse recommends:- Stripe for web apps
- RevenueCat for mobile apps
Stripe issues
Common Stripe issues:- checkout button does nothing
- user returns from checkout but premium access is not unlocked
- subscription status does not update
- billing page is missing
- free users can access paid features
- paid users still see locked states
RevenueCat issues
Common RevenueCat issues:- paywall does not open
- purchase does not unlock premium access
- restore purchases does not work
- subscription status is missing
- mobile app shows the wrong paid/free state
- game unlocks do not persist
Deployment is blocked
Deployment requires a paid subscription. If you cannot deploy, check:- your current plan
- whether the project is ready to publish
- whether the build has errors
- whether the main flow has been tested
- whether the deployment button is available
- whether the project has a custom domain requirement
Code download is blocked
Code download requires a paid subscription. If the download option is unavailable, check whether you are on a plan that includes code download.Starter and Builder are designed for users who want to ship, deploy, and download code.
Custom domain is not working
Custom domains require a paid subscription. Common issues:- domain is not connected
- DNS records are missing
- DNS changes have not propagated yet
- domain is connected to the wrong project
- HTTPS is not ready yet
- old records conflict with the new setup
Mobile app preview does not work
Mobile previews can fail if the app has broken navigation, unsupported device layout, missing data, or incomplete mobile-specific setup. Check:- mobile navigation
- tap targets
- responsive layout
- app loading state
- login state
- storage and database access
- game or app state after refresh
- QR code or device preview path
App Store or Play Store publishing is blocked
The mobile publishing flow has four major steps:- Platforms
- Store setup
- Access
- Publish
| Blocker | What to check |
|---|---|
| Missing app name | Add the iOS or Android app name |
| Missing bundle ID | Confirm the iOS bundle ID |
| Missing package name | Confirm the Android package name |
| Missing app icon | Upload or generate an app icon |
| Missing Apple access | Add Apple developer email, 2FA flow, or App Store Connect API key |
| Missing Google access | Upload Google Play service account JSON |
| Missing screenshots | Prepare App Store or Play Store screenshots |
| App not tested | Test on a real device before submitting |
Screenshot generator issues
The App Screenshot Generator uses credits and works best when the app has real screens or clear visual references. Common issues:- screenshots look too generic
- screenshots do not match the app
- text is too small
- design is not consistent
- real app screens were not uploaded
- screenshots include unfinished or broken screens
- not enough credits
AI app discovery issues
AI App Discovery and mobile AI research are credit-based workflows. Common issues:- no results appear
- API or access is not configured
- results are too broad
- idea does not become a strong project brief
- credits run out
- the selected idea is too vague
Credits or plan limits
AI credits are used across LaunchPulse workflows, including:- app building
- app updates
- screenshot generation
- AI app discovery
- mobile AI research
- larger iterations
- credit balance
- monthly reset
- plan type
- add-on credits
- whether the current task is unusually large
API key problems
API keys are used for LaunchPulse CLI, OpenClaw, automations, and approved workflows. Common issues:| Problem | What to check |
|---|---|
| Key does not work | Confirm it was copied correctly |
| Permission denied | Check scopes |
| Automation cannot read projects | Enable Read projects |
| Automation cannot update projects | Enable Write projects |
| Automation cannot run actions | Enable Run iterations |
| Key expired | Create a new key |
| Security concern | Revoke the key immediately |
LaunchPulseClaw issues
LaunchPulseClaw is in closed beta. If you cannot access it, check:- whether your account has beta access
- whether the feature is enabled for your workspace
- whether your API key scopes are correct
- whether your Clawbot instructions are clear
- whether access controls are configured
- whether the workflow needs human review
LaunchPulse Skills issues
LaunchPulse Skills is coming soon. If you are preparing for Skills, focus on creating clear reusable instructions. A good Skill should define:- purpose
- when to use it
- inputs
- outputs
- rules
- boundaries
- examples
- success criteria
Better troubleshooting prompts
Use focused prompts. The more specific you are, the better the fix.Fix one broken flow
Ask LaunchPulse to inspect one flow from start to finish, then repair only what is broken.
Ask for expected behavior
Explain what should happen and what currently happens.
Mention the exact page
Name the page, screen, button, modal, or feature that is broken.
Ask for testing
Ask LaunchPulse to test after fixing and list what was changed.
Universal fix prompt
Use this when you are not sure what is wrong:Final pre-launch checklist
Before sharing or launching a project, check:- main user journey works
- app loads without obvious errors
- sign-up and login work if included
- database records persist after refresh
- file uploads work if included
- payments work if included
- mobile layout works if mobile app
- store publishing checklist is complete if mobile
- screenshots are clean and do not expose private data
- custom domain is connected if needed
- deployment works if needed
- paid plan is active for shipping features
- API keys and secrets are not exposed
What to avoid
Avoid:- asking LaunchPulse to fix too many unrelated things at once
- publishing before testing the main flow
- using real private data in screenshots
- adding payments before the product value is clear
- giving API keys broad scopes unnecessarily
- deploying unfinished screens
- relying on local state when data should persist
- using Storage for structured records
- using Database for large uploaded files
- exposing credentials in docs, screenshots, or public repos
When to contact support
Contact the LaunchPulse team when:- a billing or subscription issue blocks access
- credits did not apply correctly
- deployment fails after the app is ready
- mobile publishing is blocked by account access
- a beta feature is unavailable
- a payment provider connection cannot be completed
- an issue repeats after multiple focused fixes
Next steps
Write a good prompt
Learn how to ask LaunchPulse for clearer, more reliable changes.
Storage & Database
Understand how files, tables, records, and persistent app data work.
Payments & Monetisation
Troubleshoot Stripe, RevenueCat, subscriptions, paywalls, and premium access.
Publishing to App Store & Play Store
Review the mobile publishing flow and checklist.
Accounts & Subscriptions
Learn which features require a paid plan and how credits work.
API Keys
Create and manage API keys for CLI, OpenClaw, and automations.

