Assuming you’re starting from “have an app that runs in localhost, good enough to launch”

At this point:

  1. You should be able to run something ending in dev and getting a local server running
  2. Your fc:frame in your index.html should contain a link to your local server and port
  3. It’s unnecessary to have a .well-known/farcaster.json at this point

But if there are any other conflicts in your code, the following might error (just send the error to Claude)

Verify functionality using the local debugger

Setup

  1. Ensure you have the local frames.js debugger available from: https://framesjs.org/guides/debugger
  2. Open a Terminal tab or window, run “frames” to open the debugger:
  3. Insert your frame url in the top left, typically :3000 for Nextjs or :5173 for Vite

image.png

You can ignore the error and warning on the right side, it’s just saying we’re not ready for a production deploy yet.

Verification

Hit the button to launch your frame and run through the basic functionality, if you have console.logs they’ll show up in the browser inspector so open that, if you have network calls they will also show up there.

If you have errors launching your frame or if it never loads, switch to the “Request” tab on the right panel in the image and double check that the data the debugger loaded is what you’d expect.

Try impersonating other users using the top menu of the debugger to see your logged out experience or to check it also works for other people.