Astro-page-insight NPM

`astro-page-insight`

npm.io

docs | demo

This is an Astro integration that shows everything to improve from Lighthouse results directly on the page.

!IMPORTANT This result is by dev mode, so it may not be accurate.
Especially, the Score is not accurate.

Usage

Prerequisites

Astro 4.0 or later is required.

Installation

Install the integration automatically using the Astro CLI:

pnpm astro add astro-page-insight

npx astro add astro-page-insight

yarn astro add astro-page-insight

Or install it manually:
1. Install the required dependencies

pnpm add astro-page-insight

npm install astro-page-insight

yarn add astro-page-insight

Add the integration to your astro config

+import pageInsight from "astro-page-insight";

export default defineConfig({
  integrations: [
+    pageInsight(),
  ],
});

Configuration

Here is the options:

Property	Type	Default	Description
`lh.weight`	`number`	`0`	`weight` is the threshold value in the audit.
`lh.breakPoint`	`number`	`767`	`breakPoint` is used to determine whether on mobile or desktop.
`firstFetch`	`load`, `open`, `none`	`none`	`firstFetch` is used for when to do the first fetch.if `firstFetch` is `load`, will fetch on page load.if `firstFetch` is `open`, will fetch on first app open.if `firstFetch` is `none`, only fetch on user interaction.
`cache`	`boolean`	`false`	`cache` is used to enable the cache.if `cache` is `true`, will enable to cache the lighthouse report.
`build.bundle`	`boolean`	`false`	`bundle` is used to determine whether to bundle the page insight.if `bundle` is `true`, will bundle the page insight. so you can see the insight after build.It will bundle results from local cache.
`build.showOnLoad`	`boolean`	`false`	`showOnLoad` is used to determine whether to show the page insight on page load.if `showOnLoad` is `true`, will show the page insight on page load.

Example

import pageInsight from "astro-page-insight";

export default defineConfig({
  integrations: [
    pageInsight({
      lh: {
        weight: 0.5,
        breakPoint: 1024,
      },
      firstFetch: "open",
      cache: true,
      build: {
        bundle: true, // You should get value from the environment variable. (e.g. process.env.STAGING === "true")
        showOnLoad: true, // This option is only available when `bundle` is `true`.
      },
    }),
  ],
});

gitignore

If you want to ignore the cache, add the following to your .gitignore:

+ .pageinsight

Notification

You can sometimes see that the notification is displayed in the app.
There are three types of notifications:

Color	Description
`Blue`	`blue` means that results are fresh.
`Yellow`	`yellow` has two meanings.One is that the results are from the cache.The other is that fetching is in progress.
`Red`	`red` means that fetching failed.