rootURL vs. baseURL 💫

[HeroicEric]

So I'm not really sure which is correct here but I think we should make this more clear (so I can understand 😄 )

Ember Guides

The ember guides mention to specify a Root URL when "your Ember application is one of multiple web applications served from the same domain. For example, if you wanted to serve your blogging application from http://emberjs.com/blog/, it would be necessary to specify a root URL of /blog/."

Ember CLI Guides

The ember-cli guides mention to specify a Base URL "if you are deploying the app to somewhere other than the root URL (/)"

The Problem

This is confusing. I'm still not totally sure which one is the correct recommendation or maybe they both have their specific use cases but those are not clear to me.

I would have included a PR to help fix this but as I said, I'm not really sure what the answer is 😄

Can anybody halp so we can clear this up?

Related issues:

• Remove specifying rootURL from ENV
• rootURL deploy issues
• Need more consistent handling of baseURL for testing apps in subdirectories

Thanks to @davidpett for helping me out on Slack.

[locks]

I remember some discussion about potential problems with <base>, I was even under the impression it was to be removed.

[davidpett]

To further the confusion, both statements are correct. You use baseURL when you are deploying the app (meaning all app assets) to somewhere other than the domain root that it is served on (something like s3). In contrast, rootURL is used when the application root is a sub directory on the domain

[jayphelps]

Further reading:

• HistoryLocation doesn't use baseURL correctly
• Kill <base> tag

Last discussion I knew of was plans to the effect of "change rootURL to rootPath; change baseURL to origin (matching window.location.origin); extract both from document.baseURI by default" but it has not yet been done AFAIK.

[trek]

I'm going to schedule time with @rwjblue to clarify this

[michaelrkn]

@trek @rwjblue any progress figuring this out?

[michaelrkn]

@SaladFork is on this!

[michaelrkn]

Closing in favor of ember-cli/ember-cli#4905.