@guardian/libs

Libs

A collection of JavaScript libraries for Guardian projects

Table of contents

• Installation
  • Bundling
• Development
  • Requirements
  • Releasing

Installation

yarn add @guardian/libs

or

npm install @guardian/libs

or

<script src="https://unpkg.com/@guardian/libs"></script>
<script>
    // window.gu.libs = { loadScript, storage, etc }
</script>

Bundling

This package uses ES2020.

If your target environment does not support that, make sure you transpile this package when bundling your application.

Development

Requirements

1. Node LTS (latest) (nvm or fnm recommended)
2. Yarn

Releasing

Changes are automatically released to NPM.

The main branch on GitHub is analysed by semantic-release after every push.

If a commit message follows the conventional commit format, semantic-release can determine what types of changes are included in that commit.

If necessary, it will then automatically release a new, semver-compliant version of the package to NPM.

Pull requests

Try to write PR titles in the conventional commit format, and squash and merge when merging. That way your PR will trigger a release when you merge it (if necessary).