Reads the version from your packages.json and saves it in a .ts file you can include within your Angular application.

Package was renamed as it works for all TypeScript applications. Please use @saithodev/ts-appversion and adjust your commands.
Last updated 9 months ago by saitho .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install ng-appversion 
SYNC missed versions from official npm registry.


Build Status npm version npm license Known Vulnerabilities Dependency Status

This package extracts version information from your package.json and Git (if configured) and saves it into a TypeScript file. You can then access that TypeScript file from your Angular application and display the version in your Angular app.

Getting started

The package comes with a script that has to be run before the building. You might want to use prestart and prebuild inside your package.json for that:

  scripts: [
    "prestart": "node ./node_modules/ng-appversion/index.js",
    "start": "ng serve",
    "prebuild": "node ./node_modules/ng-appversion/index.js",
    "build": "ng build",

With that setup the file is updated when npm start and npm run-script build are run. Note: You won't be able to run ng build anymore as the script will not be executed. Use npm run-script build instead.

Command arguments

Argument Meaning Default
--root root directory where your package.json is located .
--file relative location of the output file (based on the root directory) ./src/_version.ts
--force-git force Git detection (deprecated, use --git instead to point to your .git directory) false
--git relative location of the folder containing the .git folder (based on the root directory) .

Receiving the versions

The script generates a TypeScript file at the location ./src/_versions.ts if you haven't provided a different location. You'll be able to import the values just like any other package:

import { version } from '../_versions';

The file will contain the following variables:

  • version is the version from the packages.json (e.g. v1.0.0)
  • versionDate is the timestamp in ISO format when the compilation/package started.
  • versionLong is the version from the packages.json PLUS the Hash of the current Git-Commit (e.g. v1.0.0-g63962e3) - will only be generated if your repository is a Git Repository
  • gitTag is the latest Git tag
  • gitCommitHash is the short hash of the last commit
  • gitCommitDate is the timestamp in ISO format of the last commit

Note: The variables starting with "git" and the variable "versionLong" will only be available for Git repositories.

Environment-related versions

In some cases it might be better to not display the version number or only the short notation. You can use the environments to display different version informations.

In the following example:

  • the dev environment will display the version timestamp
  • the staging environemnt will diplay the long version (with the Commit hash)
  • the production environment will display the simple notation


import { versionDate } from '../_versions';
export const environment = {
  production: false,
  version: versionDate,


import { versionLong } from '../_versions';
export const environment = {
  production: false,
  version: versionLong,


import { version } from '../_versions';
export const environment = {
  production: true,
  version: version,

From there you can access the version inside the Component which should display the version, e.g.:

import { Component } from '@angular/core';
import { environment } from '../environments/environment';
  selector: 'app-root',
  template: '{{title}} {{version}}'
export class AppComponent {
  title = 'app';
  version = environment.version ? 'v' + environment.version : '';

Check out the example/ directory for a working example Angular application.

Current Tags

  • 1.3.0                                ...           latest (9 months ago)

6 Versions

  • 1.3.0 [deprecated]           ...           9 months ago
  • 1.2.1 [deprecated]           ...           10 months ago
  • 1.2.0 [deprecated]           ...           a year ago
  • 1.1.0 [deprecated]           ...           3 years ago
  • 1.0.1 [deprecated]           ...           3 years ago
  • 1.0.0 [deprecated]           ...           3 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 2
Dependencies (4)
Dev Dependencies (4)
Dependents (0)

Copyright 2014 - 2017 © |