README.md

June 24, 2026 ยท View on GitHub

NgxAppVersion

npm version Package License NPM Downloads Snyk codecov stars forks HitCount

Angular directive for writing version into DOM

โœ“ Angular 22 compatible

Here's the demo or stackblitz live preview or codesandbox live preview

  • Lightweight
  • No dependencies!
  • Directive way
  • Customizable options...

๐Ÿ› ๏ธ Install

  1. Use yarn (or npm) to install the package
yarn add ngx-app-version
  1. Add provideAppVersion into your config
import { provideAppVersion } from 'ngx-app-version';

export const appConfig: ApplicationConfig = {
  providers: [
    // ...
    provideAppVersion({
      version: '1.0.0'
    })
  ]
};

or module

  import { provideAppVersion } from 'ngx-app-version';

  @NgModule({
   // ...
   providers: [
     // ...
     provideAppVersion({
       version: '1.1.1'
     })
   ]
  })

Note: Do you want to get version from package.json? Consider to use ngx-devkit-builders.

๐Ÿš€ Quick start

Directive example

<div ngxAppVersion>...</div>
<div app-version="1.1.1">...</div>

Host directive example

import { NgxAppVersionDirective } from 'ngx-app-version';

@Component({
  selector: 'app-root',
  templateUrl: './app.component.html',
  styleUrl: './app.component.css',
  hostDirectives: [NgxAppVersionDirective]
})
export class AppComponent {}
<app-root app-version="1.1.1">...</app-root>

๐Ÿ”ง Compatibility

Angularngx-app-versionInstall
>= 223.xyarn add ngx-app-version
>= 192.xyarn add ngx-app-version@2
>= 141.xyarn add ngx-app-version@1
>= 120.xyarn add ngx-app-version@0

โš™๏ธ Options

Root options

OptionTypeDefaultDescription
versionstringundefinedversion that will be rendered

๐Ÿ“ฆ Dependencies

None

๐Ÿชช License

Copyright ยฉ 2023 - 2026 Dominik Hladik

All contents are licensed under the MIT license.