Did you ever wonder how Angular applications start up?
In this article, I'll give you an overview of how Angular applications are bootstrapped. Note that this is an article for beginners, not a deep-dive.
For an Angular application to start, multiple things have to happen within the Web browser:
- The HTML of the entry point must be loaded
- The main bundle of the application must be executed
- The main bundle must load Angular and trigger the bootstrap of the root Angular application module
- Angular must bootstrap the root Angular application module, and render the application
Let's look at those steps a bit more in detail.
HTML entry point
First of all, the
index.html file is downloaded and evaluated by the Web browser:
At a minimum, the body of that HTML file must contain the root component (i.e., its entry point component); in this case
<app-root></app-root>. As soon as the Angular application gets loaded and executed, Angular will recognize it and will update the DOM with the interpolated/rendered template.
That's actually the "end" of the story. Let's rewind a bit.
JS bundles loading
If you open up the
index.html file in the sources of a brand new Angular application, you won't find any of the scripts that you saw above. Why? Because they're added by the build process. When you use the Angular CLI, it first reads the
angular.json file (or
angular-cli.json) to learn about the project's configuration. Then, based on that, it builds the whole application.
When an Angular application is built using
ng build --prod, there are a few files that are generated under
├── 3rdpartylicenses.txt ├── favicon.ico ├── index.html ├── main.1feaffbe857aaf7ee0db.js ├── polyfills.a4021de53358bb0fec14.js ├── runtime.e227d1a0e31cbccbf8ec.js └── styles.09e2c710755c8867a460.css
We've already discussed the
main.js: your application code and everything you have imported
vendor.js: third-party code that your application depends on
polyfills.js: polyfills that allow using newer features in older environments (e.g., using Angular on outdated Web browsers)
runtime.js: utility code used by Webpack to load code at runtime
<script> tags in the
index.html file, as we've seen previously.
Note that you could have additional bundles if you make use of features such as lazy-loading Angular modules.
Since those script tags are part of the
index.html file, the Web browser will also load these. But loading those is not enough for something to happen. Code must be executed for your application to start. Let's look at that next.
Main entry point execution
main bundle is the one of interest here. As I've mentioned in the previous section, it's the one containing the code of our Angular application.
That bundle actually contains our whole application code. But what part of it should be executed? Well, it is something that is configured in the
As you can see above, by default, it is the
main.ts module. Because of that configuration, the Angular CLI will ensure that the corresponding module gets loaded by Webpack and executed as soon as possible once the bundles are loaded.
Now, you know that the
main.ts file is the entrypoint for Angular applications, and why it gets loaded & executed. Now let's look at what it does!
Angular application bootstrap
If you haven't changed anything, then the
main.ts file should look as follows:
There are multiple things to notice here.
Second, if the project has been built for production, then the production mode of Angular will be enabled. This is pretty important for performance.
Finally, and most importantly, the following line will be executed:
It's a single line, but it does a lot.
platformBrowserDynamic is a module that is able to load Angular in the context of a Web browser. It loads the necessary elements of the framework and configures what needs to be. Given that Angular can run in other contexts (e.g., mobile, server-side, etc), note that there are other ways to load Angular.
So, the first part,
platformBrowserDynamic() loads Angular. Once that is done, the second part
bootstrapModule(...) instructs Angular to bootstrap the given module. By default, all Angular applications include at least an
At this point, Angular takes over, loads the components, services, directives, pipes, and whatever else your
AppModule may import, refer to, declare, etc. In fine, it will look for a component matching the
app-root selector. Normally, that component is the
Once Angular has found that component, it will render it for you and update the DOM of the page include the rendered content.
If you are curious and want to know more, then check out the following articles:
In this article, I've briefly explained how Angular applications are bootstrapped. It's not the whole story (I've left all the gory details out), but it should help you have a clearer understanding of the important steps of the process.
That's it for today! ✨
Hello everyone! I'm Sébastien Dubois. I'm an author, founder, and CTO. I write books and articles about software development & IT, personal knowledge management, personal organization, and productivity. I also craft lovely digital products 🚀
If you've enjoyed this article and want to read more like this, then become a subscriber, check out my Obsidian Starter Kit, the PKM Library and my collection of books about software development 🔥.
You can follow me on Twitter 🐦
If you want to discuss, then don't hesitate to join the Personal Knowledge Management community or the Software Crafters community.