Skip to content

508-dev/running-calorie-average

Repository files navigation

Running Calorie Average Tracker

This is a statically generated SPA that allows users to note down their calories against days, and then, if they've recorded enough calorie information, view rolling daily calorie averages for the day they're looking at.

For example, if you had 1000 calories 3 days ago, 1000 calories 2 days ago, and 2000 calories today, the app would inform you that your 3 day calorie average for today is 1333. This is useful for people that monitor their calories and want a more flexible system than hyper-strict daily calorie requirements, for example allowing such people to make up for a holiday with lots of calories with more aggressive fasting in the days before or after.

Data is stored in local storage. Long term, I'd like a more persistent data storage method, allowing both for true-offline usage (such as PWA), as well as eventually persistence against a database.

The app is developed by the software engineering co-op, 508.dev. 508.dev LLC is a software engineering co-op that functions as a design and development firm, a software consultancy, and a software engineering agency.

If you don't want to use the 508 deployed version of this app, you are free to deploy the code on your own in the manner of your choosing. It is licensed under AGPL3.

Developing

Once you've created a project and installed dependencies with npm install (or pnpm install or yarn), start a development server:

npm run dev

Building

To create a production version of your app:

npm run build

You can preview the production build with npm run preview.

Deployment

This app is currently deployed on github pages. The repo is mirrored to github for this purpose.

New deployments are triggered automatically on pushes to main.

Design

First draft design for the app

Test