https://github.com/wjdp/cylfill

⏰ Tiny app to track filling of compressed air cylinders
https://github.com/wjdp/cylfill

pwa-app scuba scuba-diving spa

Last synced: 15 days ago
JSON representation

⏰ Tiny app to track filling of compressed air cylinders

• Host: GitHub
• URL: https://github.com/wjdp/cylfill
• Owner: wjdp
• License: mit
• Created: 2022-05-15T15:55:32.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2022-05-23T00:22:05.000Z (over 2 years ago)
• Last Synced: 2024-11-19T13:19:26.884Z (3 months ago)
• Topics: pwa-app, scuba, scuba-diving, spa
• Language: TypeScript
• Homepage: https://cylfill.wjdp.uk/
• Size: 1.96 MB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# cylfill

A tiny app to help with filling air cylinders.

Go to **https://cylfill.wjdp.uk/** to try it out.

## Screenshots



  

   

  

  



## Features

- Runs a countdown for how long a cylinder should take to fill given: size, starting and desired pressure and fill rate.

- Notifies you when fill should be complete. Caveat emptor:

  - Only on devices that support it, [excludes iOS for now](https://caniuse.com/notifications).

  - If the device kills the app before fill is complete notification will not be sent.

- Works offline, you just have to visit the URL once.

- Stores state to local storage, you can close and re-open while using the app.

- Stores logs of fills to history, currently only stored locally so not shared with other users.

- Tells you the average fill rate over all time and just today.

- Can be installed to phone home screen.

## Development

- Install dependencies with `npm install`

- Run local copy with `npm run dev`

- Run tests with `npm run test`

- Run type checks with `npm run tsc`

### Pre-Commit

This project uses [pre-commit](https://pre-commit.com/), ensure you have it installed and run `pre-commit install` before making commits.

### Recommended IDE Setup

- [VS Code](https://code.visualstudio.com/) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar)

## Deployment

This repo deploys its master branch to https://cylfill.wjdp.uk/ using [Cloudflare Pages](https://pages.cloudflare.com/). Branches are deployed to `.cylfill.pages.dev`.

As the app is aggressively cached by a service worker, used for offline support, you won't get the new version straight away. To do so try the following:

1. Refresh the app

2. Close every instance of the app you have open

3. Re-open the app

# Analytics & crash logs

The app runs analytics to provide insight into how it's used and to help with improvements. You can view all analytics data [on Plausible](https://plausible.io/cylfill.wjdp.uk). I also collect crash logs using [Sentry](https://sentry.io).

# Acknowledgements

- Icons by [Tabler](https://tabler.io/)