https://github.com/entorb/eta-vue
ETA (estimated time of arrival) and MultiTimer, written in Vue.js
https://github.com/entorb/eta-vue
echarts estimated-time-of-arrival eta mdi multitimer pwa stopwatch typescript vite vitest vue vue-router vue3 vuetify weighted-least-squares weighted-linear-regression
Last synced: about 1 month ago
JSON representation
ETA (estimated time of arrival) and MultiTimer, written in Vue.js
- Host: GitHub
- URL: https://github.com/entorb/eta-vue
- Owner: entorb
- License: gpl-3.0
- Created: 2023-10-18T15:53:13.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-23T10:43:32.000Z (about 1 month ago)
- Last Synced: 2025-03-23T11:24:47.268Z (about 1 month ago)
- Topics: echarts, estimated-time-of-arrival, eta, mdi, multitimer, pwa, stopwatch, typescript, vite, vitest, vue, vue-router, vue3, vuetify, weighted-least-squares, weighted-linear-regression
- Language: Vue
- Homepage: https://entorb.net/eta/
- Size: 849 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ETA (Estimated Time of Arrival) and Multi-Timer
**ETA:** Calculate remaining (waiting) time / estimated time of arrival.
**Multi-Timer:** Set and manage multiple countdown timers.
Hosted at [entorb.net/eta/](https://entorb.net/eta/). [Feedback](https://entorb.net/contact.php?origin=eta) is highly appreciated.
This project is a complete rewrite of [github.com/entorb/eta](https://github.com/entorb/eta/) using state of the art tech-stack. It is my first project in [Vue.js](https://vuejs.org) and several tools have been explored, see below.
## ETA Use Cases
- Standing in a queue / waiting room / ...
- Estimate the time for a process/work to finish
- Homework sessions
- Lawn mowing / tractor driving / ...
- Book reading finish time
- Idle-Games
[Weighted linear regression](https://en.wikipedia.org/wiki/Weighted_least_squares) is applied to calculate the speed with an emphasis on the latest data points
## Multi-Timer Use Cases
- Boiling eggs and cooking tea in parallel
- Idle-Games
## Documentation
- [doc/ideas.md](https://github.com/entorb/eta-vue/blob/main/doc/ideas.md) shows open and completed feature ideas
- [doc/tools.md](https://github.com/entorb/eta-vue/blob/main/doc/tools.md) details how to set up the tools
- [doc/vue-how-to.md](https://github.com/entorb/eta-vue/blob/main/doc/vue-how-to.md) outlines the Vue.js tech-stack and provides links to documentation and how-tos
- [doc/issus.md](https://github.com/entorb/eta-vue/blob/main/doc/issues.md) lists problems and obstacles, faced during development
## Build and Run this Project Locally
Install npm packages\_ `npm install`
Run live-updated dev-instance: `npm run dev`
Build and run: `npm run run`
## Check code after changes
### Format and unit tests
```sh
npm run check
# this runs: format lint spell test-once
# unit test only
npm run test-once
# or run this to permanently retest upon file changes
npm run test
```
### Cypress E2E tests
```sh
npm run build
npm run preview
npm run cy:open
```
Now in Cypress navigate to "E2E Testing" -> "Firefox" -> "Start E2E Testing in Firefox"
## Update
To force-update all dependencies to their latest version:
```sh
npm i -g npm-check-updates
ncu -u
npm install
```
To force-cleanup of package cache:
```sh
rm -r node_modules package-lock.json
npm cache clean --force
npm install
```
## Support tools used for this project
- [Prettier](https://prettier.io) code formatter
- [ESLint](https://eslint.org) code linter
- [CSpell](https://cspell.org) code spell checker
- [Vitest](https://vitest.dev) unit tests
- [Cypress](https://www.cypress.io) E2E tests
- [Matomo](https://matomo.org) visitor stats (locally hosted instance)
see [doc/tools.md](https://github.com/entorb/eta-vue/blob/main/doc/tools.md)
## known issues
eslint throws
```sh
[MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of eslint.config.js is not specified and it doesn't parse as CommonJS.
Reparsing as ES module because module syntax was detected. This incurs a performance overhead.
To eliminate this warning, add "type": "module" to /Users/torben/GitHub/eta-vue/package.json.
(Use `node --trace-warnings ...` to show where the warning was created)
```
but setting `"type": "module"` in `package.json` prevents Cypress to start.
## Credits
- notification sound `481151__matrixxx__cow-bells-01.mp3` is from [freesound.org](https://freesound.org/people/MATRIXXX_/sounds/481151/)
- favicon is `timer-outline` from [MDI](https://pictogrammers.com/library/mdi/icon/timer-outline/) and converted via [favicon.io](https://favicon.io/favicon-converter/)