What is the purpose of "devStorefrontUrl"?

[AlexBa]

I have searched for more infos about "devStorefrontUrl", but haven't found anything more detailed about it.

Does anyone know what it does exactly? A concrete example or documentation would probably be helpful.

[patzick]

hey @AlexBa
you're absolutely right! The only mention that I found is here: https://frontends.shopware.com/resources/troubleshooting.html#_412-error-page-during-local-development

we'll add the description!

[mkucmus]

guilty! :)
we better add some docs about it, but the question requires an answer beforehand:

the devStorefrontUrl is a helper that is being used mainly or only for customer registration purposes:

frontends/packages/composables/src/useUser/useUser.ts

Line 180 in 87610c0

storefrontUrl: getStorefrontUrl(),

the user register endpoint requires storefrontUrl parameter in the payload that will tell the backend what domain the customer is connected to (like sales channel is not enough and also can be different domain for different language and currency - see domains options in sales channel config).

normally we could use window.location.origin but it doesn't really work well for local development or when API is hosted somewhere else which is a common practice, so here's the condition:

frontends/packages/composables/src/useInternationalization/useInternationalization.ts

Line 93 in bb7d1cb

return devStorefrontUrl ?? window.location.origin ?? "";

so this is the place where the logic takes off and the devStorefrontUrl is used for the first time.

---

the docs will be updated, thanks for pointing the missing docs about this 🥇