unplugin-info

Export build information as virutal module.

This plugin helps you add build timestamp / commit SHA / ... to your application. So you can easily check whether the production version meets your expectations.

This pacakge was originally named vite-plugin-info. Now it has been refactored using unplugin to support more tools.

However, you can still use vite-plugin-info since it works fine. Thanks to the compatibility of Vite. And the source code of vite-plugin-info is here.

Installation

1npm i -D unplugin-info

1// vite.config.ts
2
3import Info from 'unplugin-info/vite';
4
5export default defineConfig({
6  plugins: [
7    Info()
8  ]
9});

1// rollup.config.js
2
3import Info from 'unplugin-info/rollup';
4
5export default {
6  plugins: [
7    Info()
8  ]
9};

1// webpack.config.js
2
3module.exports = {
4  /* ... */
5  plugins: [
6    require('unplugin-info/webpack')()
7  ]
8};

1// nuxt.config.ts
2
3export default defineNuxtConfig({
4  modules: ['unplugin-info/nuxt']
5});

1// vue.config.js
2
3module.exports = {
4  configureWebpack: {
5    plugins: [
6      require('unplugin-info/webpack')()
7    ]
8  }
9};

1// quasar.conf.js [Vite]
2module.exports = {
3  vitePlugins: [
4    [
5      'unplugin-info/vite',
6      {
7        /* options */
8      }
9    ]
10  ]
11};

1// quasar.conf.js [Webpack]
2const Info = require('unplugin-info/webpack');
3
4module.exports = {
5  build: {
6    chainWebpack(chain) {
7      chain.plugin('unplugin-info').use(
8        Info()
9      );
10    }
11  }
12};

1// esbuild.config.js
2import { build } from 'esbuild';
3
4build({
5  /* ... */
6  plugins: [
7    require('unplugin-info/esbuild')({
8      /* options */
9    }),
10  ],
11});

1// astro.config.mjs
2
3import Info from 'unplugin-info/astro';
4
5export default defineConfig({
6  integrations: [
7    Info()
8  ],
9});

Usage

unplugin-info creates three virtual modules, ~build/time, ~build/info, and ~build/meta.

~build/time

It exports the timestamp when the vite started.

1import now from '~build/time'
2
3console.log(now)
4// There will be a log like "Fri Jun 24 2022 16:30:30 GMT+0800 (中国标准时间)"

~build/info

It exports the infomation about the current git repo. This is powered by git-repo-info and ci-info.

1import {
2  CI,
3  github,
4  sha,
5  abbreviatedSha,
6  tag,
7  lastTag,
8  commitsSinceLastTag,
9  committer,
10  committerDate,
11  author,
12  authorDate,
13  commitMessage
14} from '~build/info';
15
16// ...

~build/meta

It exports some meta data from the options of the plugin.

1// vite.config.ts
2export default defineConfig({
3  plugins: [
4    BuildInfo({
5      meta: { message: 'This is set from vite.config.ts' }
6    })
7  ]
8})

Then you can import them in your Vite app.

1import { message } from '~build/meta'
2
3console.log(message)
4// This is set from vite.config.ts

Note

Meta data will be serialized to JSON format, so you should gen it in you vite.config.ts and pass the result object.

To get TypeScript support, you can add type declaration in your env.d.ts (It is include in the official Vite project template).

1declare module '~build/meta' {
2  export const message: string;
3}

~build/package

It exports the information of the current package.json.

1import { name, version } from '~build/package';

License

MIT License © 2023 XLor