Git Product home page Git Product logo

vite-plugin-version-mark's Introduction

@censujiang/vite-plugin-version-mark

Automatically insert the version or git_commit_sha in your Vite/Nuxt project.

This release is a separate branch maintained by @censujiang. The original author is @ZhongxuYang. This version is suitable for my own company's work environment, if you want to use this plugin, please consider @ZhongxuYang's master version first.

npm version npm downloads types License

Vite Nuxt

Awesome

Demo

demo screen shot

Install

yarn add -D @censujiang/vite-plugin-version-mark
# OR npm install -D @censujiang/vite-plugin-version-mark

Usage

Vite

// vite.config.ts
import {defineConfig} from 'vite'
import {vitePluginVersionMark} from '@censujiang/vite-plugin-version-mark'

export default defineConfig({
  plugins: [
    vitePluginVersionMark({
      // name: 'test-app',
      // version: '0.0.1',
      // command: 'git describe --tags',
      ifGitSHA: true,
      ifShortSHA: true,
      ifMeta: true,
      ifLog: true,
      ifGlobal: true,
      ifImportMeta: true,
    })
  ],
})

Nuxt3+

// nuxt.config.ts
export default defineNuxtConfig({
  modules: [
    ['@censujiang/vite-plugin-version-mark/nuxt', {
      // name: 'test-app',
      // version: '0.0.1',
      // command: 'git describe --tags',
      ifGitSHA: true, 
      ifShortSHA: true, 
      ifMeta: true, 
      ifLog: true, 
      ifGlobal: true,
      ifImportMeta: true,
    }]
  ],
})

Then you can use @censujiang/vite-plugin-version-mark ! ๐ŸŽ‰

Config

@censujiang/vite-plugin-version-mark can be print application version in the Console or add <meta> in HTML element.

name description type default supported
name application name string name in package.json 0.0.1+
version application version string version in package.json 0.0.1+
ifGitSHA use git commit SHA as the version boolean false 0.0.1+
ifShortSHA use git commit short SHA as the version boolean true 0.0.1+
ifLog print info in the Console boolean true 0.0.1+
ifGlobal set a variable named `__${APPNAME}_VERSION__` in the window boolean true 0.0.4+
ifMeta add <meta name="application-name" content="{APPNAME_VERSION}: {version}"> in the <head> boolean true 0.0.1+
ifImportMeta add import.meta.env.__${APPNAME}_VERSION__ in the App boolean true 0.0.9+
command provide a custom command to retrieve the version
For example: git describe --tags
string git rev-parse --short HEAD 0.0.8+

View CHANGELOG

vite-plugin-version-mark's People

Contributors

censujiang avatar kgutwin avatar zhongxuyang avatar

Stargazers

 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.