Troubleshoot

A guide to help you with common issues faced when working with Hanko.

CORS error

Console

Hanko Auth Component

CORS errors usually occur when the application URL hasn’t been correctly configured in Hanko Cloud. If you’re developing your project on localhost, you’ll need to add a URL like http://localhost:3000. For production, you’ll need to add the production URL. Please follow this guide for a seamless setup of Hanko Cloud.

404 (Not Found)

Console

Hanko Auth Component

This error typically arises when the API URL has been incorrectly configured. Depending on your framework, you may need to prefix your URLs with PUBLIC, NEXT_PUBLIC, or another specific prefix. This prefixing ensures that these environment variables are exposed to the browser and can be accessed by your frontend.

Here are some of the examples

.env

Next.js
NEXT_PUBLIC_HANKO_API_URL=https://f4****-4802-49ad-8e0b-3d3****ab32.hanko.io

Nuxt
NUXT_PUBLIC_HANKO_API_URL=https://f4****-4802-49ad-8e0b-3d3****ab32.hanko.io

SvelteKit
PUBLIC_HANKO_API_URL=https://f4****-4802-49ad-8e0b-3d3****ab32.hanko.io

React
REACT_APP_HANKO_API_URL=https://f4****-4802-49ad-8e0b-3d3****ab32.hanko.io

'r' is read-only error when deploying a CRA

You might get "r" is read-only error after you deploy a CRA (Create React App). To fix it you’ll need to add @babel/core as a dependency in your project. You can do this by running the following command:

npm install @babel/core

My issue is not listed here

Feel free to open a GitHub Issue or join our Discord Community. We’re here to help!