hanko icon indicating copy to clipboard operation
hanko copied to clipboard

Add deployment section in docs

Open ayushsgithub opened this issue 1 year ago • 1 comments

Checklist

  • [X] I could not find a solution in the existing issues or docs.
  • [X] 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

ayushsgithub avatar Oct 26 '23 10:10 ayushsgithub

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.

FlxMgdnz avatar Oct 27 '23 11:10 FlxMgdnz