vite plugin singlefile compression

Compress all assets and embeds them into dist/index.html, making it convenient to share as a single HTML file.

The recipient can open it directly in the browser without manually unzipping the file.

Using DecompressionStream + base128-ascii.

Preview: https://bddjr.github.io/vite-plugin-singlefile-compression/#/

Setup

npm i -D vite-plugin-singlefile-compression@latest

Then modify vite.config.ts, like website/vite.config.ts

+ import singleFileCompression from 'vite-plugin-singlefile-compression'

  export default defineConfig({
    plugins: [
      vue(),
      vueDevTools(),
+     singleFileCompression(),
    ],

Then use hash history, like website/src/router/index.ts

  const router = createRouter({
-   history: createWebHistory(),
+   history: createWebHashHistory(),

To automatically restore the user's scroll position after a page reload or back/forward navigation, add the following code to the end of src/main.ts:

// Restore scroll position after page reload or back/forward navigation
{
  const storageKey = 'globalScrollXY'
  const item = sessionStorage.getItem(storageKey)
  if (item !== null) {
    try {
      sessionStorage.removeItem(storageKey)
      const navEntry = self.performance.getEntriesByType('navigation')[0] as
        | PerformanceNavigationTiming
        | undefined
      const navType = navEntry?.type
      if (navType === 'reload' || navType === 'back_forward') {
        const [x, y] = item.split(',', 2)
        setTimeout(() => {
          self.scrollTo({
            left: Number(x),
            top: Number(y),
            behavior: 'instant',
          })
        }, 1)
      }
    } catch (e) {
      console.error(e)
    }
  }
  const saveScrollPosition = () => {
    sessionStorage.setItem(storageKey, `${self.scrollX},${self.scrollY}`)
  }
  self.addEventListener('pagehide', saveScrollPosition)
  document.addEventListener('visibilitychange', () => {
    if (document.visibilityState === 'hidden') saveScrollPosition()
  })
}

Options

Example:

singleFileCompression({
  rename: 'example.html'
}),

rename

Rename index.html

type: string

enableCompress

Enable compress.

default: true

type: boolean

useBase128

Use Base128 to encode compressed script.
If false, use Base64.
https://www.npmjs.com/package/base128-ascii

This option is only valid when the enableCompress option is set to true.

default: true

type: boolean

compressFormat

Compress format.

https://developer.mozilla.org/en-US/docs/Web/API/DecompressionStream/DecompressionStream

This option is only valid when the enableCompress option is set to true.

default: "deflate-raw"

type:

• "deflate-raw"
• "deflate"
• "gzip"
• "brotli"
• "zstd"
• "deflateRaw"
• "gz"
• "br"
• "brotliCompress"
• "zstandard"
• "zst"

compressor

Custom compressor.

This option is only valid when the enableCompress option is set to true.

type: (script: string) => (Uint8Array | Promise<Uint8Array>)

htmlMinifierTerser

https://github.com/terser/html-minifier-terser?tab=readme-ov-file#options-quick-reference

default: defaultHtmlMinifierTerserOptions

type:

• HtmlMinifierOptions
• boolean

tryInlineHtmlAssets

Try inline html used assets, if inlined or not used in JS.

default: true

type: boolean

removeInlinedAssetFiles

Remove inlined asset files.

default: true

type: boolean

tryInlineHtmlPublicIcon

Try inline html favicon, if icon is in public dir.

default: true

type: boolean

removeInlinedPublicIconFiles

Remove inlined html favicon files.

default: true

type: boolean

enableCompressInlinedIcon

Enable compress inlined html favicon.

This option is only valid when the enableCompress option is set to true.

⚠️ Not works on Safari (See #20)

default: false

type: boolean

useImportMetaPolyfill

Use import.meta polyfill.

default: false

type: boolean

quiet

Do not log.

default: false

type: boolean

Effect

Preview: https://bddjr.github.io/vite-plugin-singlefile-compression/#/

vite v8.0.16 building client environment for production...
✓ 43 modules transformed.
rendering chunks (1)...

vite-plugin-singlefile-compression 2.4.8 deflate-raw base128-ascii

  file:///D:/code/js/vite-plugin-singlefile-compression/website/dist/index.html
  130.041 kB -> 61.141 kB

Finish.

computing gzip size...
dist/index.html  61.14 kB │ gzip: 45.99 kB

✓ built in 330ms

Clone

git clone https://github.com/bddjr/vite-plugin-singlefile-compression
cd vite-plugin-singlefile-compression
pnpm i
pnpm build