Performance checklist for Vue and Nuxt

Explore by Category:


Performance checklist for Vue and Nuxt

Improving the performance of web applications will always be sexy. We want the page to load faster, smoother, and without too many layout shifts (Core Web Vitals, I am looking at you 😉). If you search in Google for terms like vue/nuxt performance you will get a bunch of documentation and articles you can use to improve the performance of your page. In this article, I wanted to summarize all this knowledge into one single source of truth (with respect to article authors).

Technical Whitepaper


This summary document is based on the following articles:

... and my own knowledge that I gathered throughout the years.

Make sure to visit these articles and give a solid "like" to all of them and their authors 😊

You can also check out another article I have written recently about continuously measuring the performance of Nuxt.js applications using Lighthouse CI and Github Actions .

Just please remember that improving performance is not an issue that you can just sit once and fix. It is a continuous process and the topic of performance should be addressed regularly so that new features of your website (for sure needed) won't break the performance.

Preload key requests / Preconnect to required origins

Declare preload links in your HTML to instruct the browser to download key resources as soon as possible.

```html ```

Consider adding preconnect or dns-prefetch resource hints to establish early connections to important third-party origins.

```html . ```

dns-prefetch works exactly the same as preconnect but has wider browser support.

Reduce third-party usage

Third-party code can significantly impact load performance. You can however modify the way you are using this third party library by:

  • Loading the script using the async or defer attribute to avoid blocking document parsing.
  • Self-hosting the script if the third-party server is slow.
  • Removing the script if it doesn't add clear value to your site.
  • Use link rel=preconnect or link rel=dns-prefetch to perform a DNS lookup for domains hosting third-party scripts.

Eliminate render-blocking resources

Resources are blocking the first paint of your page. Consider delivering critical JS/CSS inline and deferring all non-critical JS/styles. You can reduce the size of your pages by only shipping the code and styles that you need.

Once you've identified critical code, move that code from the render-blocking URL to an inline script tag on your HTML page.

Inline critical styles required for the first paint inside a style block at the head of the HTML page and load the rest of the styles asynchronously using the preload link.

Read more:
How do I test my website for render-blocking resources ?

Minify/Remove unnecessary CSS and JS

When you are building a big application, you will get to a place where your project may have much more code than it actually needs and uses.

Use tools like CSS Minification or Terser JS Plugin . In Nuxt, Terser is included by default.

To eliminate unused CSS use a tool like PurgeCSS .

To eliminate unnecessary JavaScript you can use Terser mentioned previously or utilize Tree Shaking to allow Dead Code Elimination. You can also use Code Splitting which will split code into bundles that can be loaded on demand.

Nuxt provides code-splitting out of the box.

Scan modules for duplicates

Remove large, duplicate JavaScript modules from bundles to reduce final bundle size.


Use Webpack Bundle Analyzer or --analyze flag in Nuxt.js

Reduce execution time

The combination of code splitting, modification, and compression, removal of unused code, and caching techniques will greatly improve execution time.

Consider reducing the time spent parsing, compiling, and executing JS. You may find delivering smaller JS payloads helps with this.

The idea is to optimize both our JS and CSS code, minimizing it and removing unused code, as well as the third-party libraries we are using.

Keep the server response time for the main document short because all other requests depend on it.

Read more:
Lighthouse: Reduce JavaScript execution time

Image handling

Properly size images

Serve images that are appropriately-sized to save cellular data and improve load time.

```html ```

Read more:
Properly size images

Efficiently encode images

Optimized images load faster and consume less cellular data.

Using your image CDN service or the compression of your image should be enough.

Read more:
Efficiently encode images

Serve images in next-gen formats

Image formats like WebP or Avif often provide better compression than PNG or JPEG, which means faster downloads and less data consumption.

Read more:
Serve images in modern formats

Image elements have explicit width and height

Set an explicit width and height on image elements to reduce layout shifts and improve CLS.

Read more:
Lighthouse: Use explicit width and height on image elements

Preload larges contenful paint (LCP)

Preload the image used by the LCP element in order to improve your LCP time.

```html ``````js head() { return { link: [ { rel: 'preload', as: 'image', href: 'path/to/lcp/image', }, ], } } ```

Read more:
Lighthouse: Preload Largest Contentful Paint image


All text remains visible during webfont loads

Leverage the font-display CSS feature to ensure text is user-visible while webfonts are loading.

```css @font-face { font-family: 'Arial'; font-display: swap; } ```

The font-display API specifies how a font is displayed. Swap tells the browser that text using the font should be displayed immediately using a system font. Once the custom font is ready, it replaces the system font.

For Google fonts, for example, is as simple as adding the &display=swap parameter to the end to the Google Fonts URL:

```html ```

Read more:
Ensure text remains visible during webfont load

What to avoid?

Large layout shifts

Cumulative Layout Shift (CLS) is a Core Web Vitals metric calculated by summing all layout shifts that aren’t caused by user interaction.

Excessive DOM size

A large DOM will increase memory usage, cause longer style calculations, and produce costly layout reflows.

Multiple page redirects

Redirects introduce additional delays before the page can be loaded.

Serving legacy JavaScript to modern browsers

Polyfills and transforms enable legacy browsers to use new JavaScript features. However, many aren't necessary for modern browsers.

In Nuxt we have --modern with some options in the build command.

Enormous network payloads

Large network payloads cost users real money and are highly correlated with long load times.

  • Defer requests until they're needed. Nuxt is taking care of it.
  • Optimize requests to be as small as possible, minimizing and compressing, try to use WebP for the images when it's possible. An image CDN will be always there to keep our performance up!
  • Cache requests so the page doesn't re-download the resources on repeat visits.


For users on slow connections, external scripts dynamically injected via document.write() can delay page load by tens of seconds.

Non-compositioned animations

Animations which are not composited can be heavy and increase CLS. Use translate and scale CSS properties instead.

Framework improvements

We went through things that you can do with your HTML, CSS, and JavaScript. Now, let's tackle the framework layer to see what we can do to improve the performance of our website.

Asynchronous Components

Asynchronous Components allow you to only load Components when a specific condition is matched.

``vue ```

Route based code splitting

Only the code from the route that is currently visited by the user will be downloaded.

So instead:

```js // router.js import Home from './Home.vue' import About from './About.vue' const routes = [ { path: '/', component: Home } { path: '/about', component: About } ] ```

We could write this:

```js // router.js const routes = [ { path: '/', component: () => import('./Home.vue') } { path: '/about', component: () => import('./About.vue') } ] ```

If you’re using Nuxt this is out of the box. Nuxt’s default directory-based routing system is code-splitting every route by default.

Use reactivity when it is actually needed

Overloading your page with too many reactive properties will make your page slower (especially using Vue 2). Make sure to use them only when needed and other static values that won't be changed over time, store them in constant variables.

So instead:

```js export default { data() { return { milisecondsInAnHour: 3600000, } }, computed: { getMilisecondsInAnHour() { return this.milisecondsInAnHour } } } ```

Write something like this:

```js const MILISECONDS_IN_AN_HOUR = 3600000; export default { computed: { getMilisecondsInAnHour() { return MILISECONDS_IN_AN_HOUR } } } ```

Eliminate memory leaks

The easiest example of a memory leak is registering an event listener and not properly unregistering it.

```js export default { created() { target.addEventListener(type, listener); } } ```

To avoid that, make sure to include removeEventListener on destroy lifecycle hook.

Optimize third party packages

Many popular third party packages provide lighter versions that you can check using . Bundlephobia helps you find the performance impact of npm packages. Find the size of any javascript package and its effect on your frontend bundle.

Make sure to use libraries that support tree shaking to only load code that will be used in the final configuration.

Some libraries like lodash support importing direct files instead of the whole library. So instead of writing this:

```js import { isNull } from 'lodash' ```

We can use this:

```js import isNull from 'lodash/isNull` ```

[Nuxt] Use plugins only if they are used app-wide

Plugins are a great way to provide application wide logic, but that also means that they are loaded application wide. If it turns out to be a piece of logic you’ll only need in certain conditions or certain pages consider loading it via dynamic import at these places.

[Infrastructure] Use a Content Delivery Network (CDN)

A CDN allows for the quick transfer of assets needed for loading Internet content including HTML pages, javascript files, stylesheets, images, and videos.

The build.publicPath option allows you to configure a CDN for all assets.

Useful Vue & Nuxt Packages

In terms of improving performance of your website there are several packages available you can use.

Implement Progressive Web App

@nuxjs/pwa package

PWA will cache all of the resources needed to load our app. Not only the static files like JS and CSS, but it also caches the images. Even the API response is cached as well.

```js pwa: { manifest: { name: 'My Awesome App', lang: 'fa', } } ```

Preconnect fonts

@nuxtjs/google-fonts package

If you are using Google Fonts like Roboto, Raleway, etc, you can use this package to not block the page from rendering.

```js googleFonts: { families: { Roboto: true, Raleway: { wght: [100, 400], ital: [100] }, } } ```

Use Optimized Images

@nuxtjs/image package

Make sure all images have right sizes and/or use external Digital Asset Management like Cloudinary to optimize images on the fly.

Purge Unnecessary CSS

nuxt-purgecss package

PurgeCSS analyzes your content and your CSS files. Then it matches the selectors used in your files with the one in your content files. It removes unused selectors from your CSS, resulting in smaller CSS files.

Lazy Hydration

vue-lazy-hydration package

The idea of lazy hydration is to be able to control what components are hydrated (with JavaScript), when and under what conditions.

```html ```

Image Lazy Loading

vue-lazyload package

The idea of lazy loading images is to delay sending requests for images to the point the image appears in the viewport. So basically, if you have an image in the footer, the request for it will be done when user scrolls down to it.

```html ```

Infinite Loading

vue-infinite-loading package

The idea of the infinite load is as the user scrolling through the page goes on, we load the next paginated data.

```vue ```

Use Compression (Brotli)

nuxt-compress package

Adding Brotli compression will reduce the overall file size of your application by a relevant margin, Alexander Lichter wrote a [great article]( about how to add it.

```js module.exports = { modules: [ ['nuxt-compress', { brotli: { threshold: 8192, }, }], ], }; ```


nuxt-ssr-cache package

Cache is a hardware or software component that stores data so that future requests for that data can be served faster.

```js cache: { useHostPrefix: false, pages: [ '/page1', '/page2', ], store: { type: 'memory', max: 100, ttl: 60, }, }, ```


  • Make sure to include `min-height` for all your main pages. We encountered this problem in Alokai, that we were fetching the data from an Ecommerce platform and because of that it took some time for the content to arrive and it was causing layout shift (which resulted in worse Ligthouse results that were relatively easy to fix).
  • Make sure to scan your components for unnecessary imports. When developing huge application, it is common to refactor your pages to that you are constantly adding or removing components. It is really easy to loose track of used and unused components/helpers/etc.
  • Check your build configuration in `nuxt.config.js`. To decrease final bundle you can add `extractCSS: true` to your `build` object. In our case it resulted in decreasing the final bundle by about 60 KB (20% of overall size).

Wrapping up

Thanks for reading our performance checklist for Vue and Nuxt! We hope you found these tips and best practices helpful in optimizing your applications. If you have any questions or need further assistance with optimizing your Vue and Nuxt applications, feel free to contact us . Don't let performance issues hold your application back - take action now and see the difference in user experience and business outcomes. Keep checking back for more tips and resources on optimizing your Vue and Nuxt applications!

Headless Commerce 101



Frequently asked questions


Ready to dive in? Schedule a demo

Get a live, personalised demo with one of our awesome product specialists.