One of the nice features of Angular is the built-in support it has to use “real” looking URLs such as
/stuff/ instead of URLs with hashes/fragments, e.g.
#/stuff (which we’ve gotten used to in the SPA world).
A lot of developers mess settings this up the first time. It is frustrating that it seems to work except in certain situations when set up bad (refreshing doesn’t work, or links are broken, etc.). But if you know what buttons to push: it actually just requires a little work on your Angular app and some configuration on your server side.
Client set up
First, you need to add a
config() block to enable
html5Mode like so:
1 2 3
This enables HTML5 mode in Angular. This mode means Angular will use the
pushState API to change the browser’s URL without causing a reload when possible (if you’re using a legacy browser that doesn’t support it, Angular will automatically fallover to using hashes as always).
The second change on the client is to not have the hashes in your links. For example change
<a href="#/stuff">Stuff</a> to
And the last client change is to add to your index.html file, under the
<head> section a
<base> tag, e.g.
<base href="/">. This tells Angular what is the base path of your app so it would know how to change the browser URL correctly. For example, if your Angular app’s root is under
http://www.example.com/app, you should probably have a base tag set to
Server set up
Essentially this depends on what server solution you have for serving Angular’s assets. You need to make it so that when the browser tries to access some “fake” URL, like
/users/123, it would serve your Angular app. A lot of people first skip this step and then don’t understand why they get 404 errors when refreshing their apps.
Of course I can’t go over all the different server side technologies here, but as an example, here’s the basic nginx configuration:
1 2 3 4
Happy state pushing!
“Maintaining AngularJS feels like Cobol 🤷…”
You want to do AngularJS the right way.
Yet every blog post you see makes it look like your codebase is obsolete. Components? Lifecycle hooks? Controllers are dead?
It would be great to work on a modern codebase again, but who has weeks for a rewrite?
Well, you can get your app back in shape, without pushing back all your deadlines! Imagine, upgrading smoothly along your regular tasks, no longer deep in legacy.
Subscribe and get my free email course with steps for upgrading your AngularJS app to the latest 1.6 safely and without a rewrite.