Getting StartedSolveBuildIntelligenceLearnHelpWhat's New
GUIDES

Debugging

Debug apps in Rocket.new Build with prompts: describe errors clearly, isolate broken components, reproduce issues, and apply safe fixes step by step.

When something in your app is not working as expected, debugging means figuring out what is wrong and fixing it. In Rocket, you do this by explaining the problem clearly so the AI can help you fix it without starting over.

This guide covers:

  • How to describe problems so they are easy to fix
  • Quick commands for common issues
  • How to make small, safe fixes instead of big rewrites
  • Common integration errors and fix prompts

When something goes wrong

Before you write a long message, try these quick checks:

Sometimes the page just needs to reload.

If you know what broke it, undo it.

Look for spelling mistakes in names and labels.

Make sure your connections and configuration are correct.

Try simple commands before writing a long debugging message:

  • /Fix Navigation Issues for broken links or pages not loading
  • /Fix Layout Issues for spacing, alignment, or things looking wrong
  • /Fix Theme Switching for problems switching between light and dark mode

How to describe problems

The best way to get help is to explain your problem clearly. Use this template:

1. What I expected:
   [Describe what should happen]

2. What actually happened:
   [Describe what happens instead]

3. Error message (if any):
   [Copy any error messages you see, or say "no error message"]

4. Where this is happening:
   [Which page or part of your app]

5. What I already tried:
   [List anything you already checked or changed]

Then ask Rocket to help:

Based on this information, explain what is most likely causing this issue.
Then suggest a safe, minimal change to fix it.

Example

1. What I expected:
   On the login page, when I enter my login information and click submit,
   I should go to the main dashboard page.

2. What actually happened:
   I click submit, the button shows it is working for a moment,
   but then I stay on the login page. The page address does not change.

3. Error message (if any):
   I see an error message that says: "Cannot read property 'userId' of undefined"

4. Where this is happening:
   The login page

5. What I already tried:
   - Checked that my login information is correct
   - Made sure the information is being saved
   - Tried opening in a different browser

Step-by-step guide when something breaks

Look for any error messages on the screen or in the browser.

  • If you see an error message, copy the exact text and use it in your problem description.
  • If you do not see an error message, move to the next step.

Compare what is on the page to what you expected.

  • If something looks wrong, describe what you expected and what you actually see.
  • If everything looks correct, move to the next step.

If clicking buttons or interacting with the page does nothing at all:

  • Look more carefully for error messages you might have missed
  • Describe what should happen when you interact with the page
  • Describe what actually happens (nothing)

Use the template from "How to describe problems" above to organize what you found. Include the error message, what looks wrong, or what does not respond.

Quick commands for common problems

Rocket has special commands that can fix common problems quickly. Try these before writing a longer message.

Layout and spacing

  • /Fix Layout Issues fixes things that look misaligned or spaced wrong
  • /Fix Layout Issues in pricing grid fixes layout in a specific area
  • /Fix Layout Issues for mobile breakpoints fixes responsive layout issues
  • /Fix Navigation Issues fixes broken links or pages that do not load
  • /Fix Navigation Issues in header navigation targets a specific area
  • /Fix Navigation Issues for dashboard routes targets specific routes

Theme

  • /Fix Theme Switching fixes problems switching between light and dark mode

Login and authentication

  • /Fix Supabase Authentication Issues fixes common login and signup problems
  • /Fix Supabase Authentication Issues for users who can sign up but cannot log in targets a specific scenario

Code organization

  • /Organize Code cleans up messy or hard-to-find code
  • /Organize Code in src/components/dashboard.tsx targets a specific file

Scoping changes to one file

Use @ followed by the file name to make sure changes only happen in that file:

@pages/login.jsx fix the submit button behavior

Common problems and how to fix them

Example: Fixing a login problem

Here is how a vague message becomes a clear one.

Bad (too vague):

The login is broken, please fix.

Does not say which page, does not explain what should happen, no error message or details.

Better (still needs work):

Login does not work after the user signs in.

Good (clear and actionable):

First try /Fix Supabase Authentication Issues. If that does not work, use a detailed description:

1. What I expected:
   On the login page, when I enter my login information and click submit,
   I should go to the dashboard page.

2. What actually happened:
   I click submit, the button shows it is working for a moment,
   then I stay on the login page. The page address does not change.

3. Error message:
   I see an error message that says: "Cannot read property 'userId' of undefined"

4. Where this is happening:
   The login page

5. What I already tried:
   - Checked that my login information is correct
   - Made sure the information is being saved
   - Tried opening in a different browser
   - Tried /Fix Supabase Authentication Issues

Then follow up:

@pages/login.jsx based on this information, identify the most likely cause of the issue
and propose a small, focused fix. Explain the change before applying it.

What to avoid

Being too vague

Do not do this: "The form is broken."

Instead:

On the "Contact" form, clicking "Submit" does nothing:
- Nothing happens when I click
- No success or error message appears
- No information is being sent

Help me fix only the submit button behavior.

Or even better: @pages/contact.jsx fix the submit button behavior. Nothing happens when clicked, no error appears, and no data is sent.

Asking for too much at once

Do not do this: "Fix the checkout process."

Instead:

On the checkout page, the payment button shows it is working but never finishes.
The form checks work correctly. Focus only on making the payment button work.

Or: @pages/checkout.jsx fix the payment button so it completes properly. The form validation works correctly.

Not giving enough details

Do not do this: "The table is not showing information."

Instead:

The "Orders" table is empty even though there are orders stored in the system.
The table layout looks correct, but no rows appear. Check how information
is loaded for this table.

Saying "sometimes it does not work"

Do not do this: "Filtering does not always work."

Instead:

On the "Orders" table, filtering by status works for
"Pending" and "Completed", but selecting "Cancelled"
shows an empty table even though there are cancelled orders
stored in the system.

Focus on making filtering work for the "Cancelled" status.
Do not change how the table looks or how it is styled.

When your messages are not working

If you have used the template above but Rocket keeps making changes that do not help:

SituationWhat to try
Fix is completely wrongBe more specific about the problem. Use the template structure.
Fix is partially rightAdd more details about the problem. Include error messages and location.
Changed the wrong partsClearly state what NOT to change. Use @ to scope to one file.
Fix changes each timeBreak the problem into smaller parts. Fix one issue at a time.
Ignores your existing workPoint to similar parts that work correctly. Show what you want it to look like.

If you are stuck, try explaining the problem to someone else in plain English. The words you use to explain it are often the words you should use in your message to Rocket.

Common integration errors

The most frequent integration errors for Supabase, Stripe, email, AI, and deployment are documented with causes and fix prompts in the Troubleshooting page. If you are hitting an error from a connected service, check there for step-by-step solutions.


What's next?

On this page