teamhanko / hanko

Authentication and user management for the passkey era.

Home Page:https://hanko.io

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Add deployment section in docs

ayushsgithub opened this issue · comments

Checklist

  • I could not find a solution in the existing issues or docs.
  • I agree to follow this project's Code of Conduct.

Description

I recently encountered an issue during the deployment of a Next.js project on Vercel, where CORS (Cross-Origin Resource Sharing) issues emerged after deployment. I believe this issue could be addressed in the documentation to help new developers avoid this common pitfall and improve their deployment experience.

Describe your ideal solution

To avoid CORS issues, it's necessary to update the application's URL or domain configuration after deployment. This can typically be done in the Hanko Cloud Console under settings -> general -> appurl

By making this simple adjustment, it'll avoid unnecessary troubleshooting.

Workarounds or alternatives

No response

Hanko Version

0.8.4

Additional Context

No response

Thanks, we see some users struggling with the CORS issue when not updating the App URL for hosted environments. Any ideas how we can improve the docs are welcome.

Though we generally recommend to create two projects on Hanko Cloud, one for development, and one for hosted / production deployment. This has the following benefits:

  • Your test users don't appear in your live app
  • You can test different Hanko settings in development / staging

We probably should think about how we can make this more clear on Hanko Cloud as well.