Issue: `convex dev` hangs indefinitely on "Preparing Convex functions..." step
Environment:
- Node v22.0.0, bun 1.2.4
- Convex deployment:
dev:fiery-okapi-709
- macOS (Darwin 24.5.0)
Details:
- Happens with both bunx convex dev
and npm exec convex dev
- Verbose output shows it reaches "Bundling modules for Convex's runtime..." then hangs
- Even occurs with minimal function (simple hello world query)
- TypeScript compilation passes without errors
- Tried killing existing processes, no effect
Workaround attempts:
- Used --once
flag - still hangs
- Tried CONVEX_DEBUG=1
- no additional info
- Simplified functions to basic hello world - still hangs
Anyone seen this before or have suggestions? 🤔5 Replies
Thanks for posting in <#1088161997662724167>.
Reminder: If you have a Convex Pro account, use the Convex Dashboard to file support tickets.
- Provide context: What are you trying to achieve, what is the end-user interaction, what are you seeing? (full error message, command output, etc.)
- Use search.convex.dev to search Docs, Stack, and Discord all at once.
- Additionally, you can post your questions in the Convex Community's <#1228095053885476985> channel to receive a response from AI.
- Avoid tagging staff unless specifically instructed.
Thank you!
could be some bad tsconfig setting for convex possibly.
I’m also experiencing this problem. it’s persisted through reinstalls on WSL2 and node 24
As additional context:
npx convex dev
worked fine momentarily when I had the CLI create a new project, but after a few minutes it went back to hanging. Designating existing projects always leads to hangs.
Rolling back to convex-js 1.25.0 resolves the issue.Still seeing problems with latest convex-js?
It's happening to me, suddenly it stopped working, is stuck in
Bundling modules for Convex's runtime...
when running with --verbose.