https://github.com/dev-jan/ngsw-rehash
Rehash files for ngsw (Angular Service Worker) dist config
https://github.com/dev-jan/ngsw-rehash
Last synced: about 2 months ago
JSON representation
Rehash files for ngsw (Angular Service Worker) dist config
- Host: GitHub
- URL: https://github.com/dev-jan/ngsw-rehash
- Owner: dev-jan
- License: mit
- Created: 2021-12-11T14:39:07.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2026-03-19T19:50:44.000Z (2 months ago)
- Last Synced: 2026-03-20T10:51:17.112Z (2 months ago)
- Language: Go
- Size: 9.77 KB
- Stars: 2
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ngsw-rehash
This is a simple program to update the hashes inside of a ngsw.json file. This file is used by Angular webapps to configure a Service Worker and to update the files from the server correctly.
Features:
- Dead-Simple CLI interface, just pass the path to the ngsw.json file of the dist folder
- No dependency needed (single statically linked binary)
- Small footprint (ready be used inside docker images)
## Why update this file?
Image you want to change some of the final dist files of your angular webapp on runtime. For example to the the correct API endpoint URL on the startup of the frontend docker container. This will alter the hash of the edited file and will break the PWA caching of that file. To fix this, you can simply run ngsw-rehash after altering the file and the hash will be correct :rocket:.
## Example
Download the binary into your final image using the following statements inside your Dockerfile:
```
ADD https://github.com/dev-jan/ngsw-rehash/releases/download/v1.2/ngsw-rehash-linux-x86 /usr/bin/ngsw-rehash
RUN chmod +x /usr/bin/ngsw-rehash
# Optionally, check if the hash matches (sha256sum must be installed for this):
RUN echo "9463725b2d1c807b2dc803526e7572722dd3cd938ae70c4524e2b8e70b37c1d6 /usr/bin/ngsw-rehash" | sha256sum -c -;
```
You then can use the binary for example in a startup script to dynamically inject
environment specific values:
```bash
sed "s,BACKEND_URL,https://fancy-api-url-prod.example.com/,g' dist/your-app/index.html
ngsw-rehash dist/your-app/ngsw.json
```
## Alternatives?
There is a command inside the Angular CLI that does basically the same as this tool. If you have the whole Angular CLI available while you want to recreate the hashes, maybe you should better use this one:
```bash
node_modules/.bin/ngsw-config dist src/ngsw-config.json
```
But for this command you have to install the Angular CLI, which blows up for example your Docker image. As normally this is not needed, this simple tool can help keep the images small and still be able to recreate the hashes for changed files.