Troubleshooting

Common Issues

Find a Doc requires Node.js >= 22.12.0. Check your version:

node --version

We recommend using nvm or fnm to manage Node.js versions:

nvm install 22
nvm use 22

The project uses Yarn 4.x via Corepack. If you encounter Yarn errors:

corepack enable
corepack prepare yarn@4 --activate

If yarn dev fails because port 3000 is already in use:

# Find the process using port 3000
lsof -i :3000

# Kill it
kill -9 <PID>

Or start the dev server on a different port:

npx nuxi dev --port 3001

If you get type errors after pulling new changes, regenerate the GraphQL types:

yarn generate

Run the linter with auto-fix:

yarn lint:fix

If the local Supabase instance isn't starting:

# Make sure Docker is running, then:
npx supabase start
npx supabase db reset

If you're stuck, don't hesitate to ask for help: