Skip to content

LiamMorrow/LiftLog

Repository files navigation

LiftLog

Discord

Get it on Google Play Download on the App Store Try demo in your browser

LiftLog aims to be an intuitive, simple gym weight tracking app. It runs on all mobile platforms, and is built as a .NET MAUI Blazor Hybrid app. It incorporates material design 3, with designs and layout driven by tailwindcss.

Built into it is an AI planner which will tailor a specific gym plan to your goals and body.

LiftLog also allows users to publish their workouts to their feed, and subscribe to other user's feeds. This data is end to end encrypted and totally opt in. User's have full control over who can follow them. The technical details of how this works are described in the feed process docs.

Checkout the app website for screenshots and features. Or checkout https://app.liftlog.online to try it out without installing an app.

Quickstart

Prerequisites

Ensure the dotnet sdk is installed and on the latest version. You can do that by following the instructions here. npm is also required to build some of the web assets.

Running

Before running, you must build the web assets once, after they are built it is rare to need to build them again.

cd ./LiftLog.Ui
npm i
npm run build

Then, to run the app in the browser simply run:

cd ../LiftLog.Web
dotnet watch

Project Structure

As mentioned, LiftLog is a MAUI Hybrid Blazor app. What this means for LiftLog is that all of the UI is built with blazor in html, css, and a bit of JS. Since the entire UI is built this way, rapid development using the browser is possible; without having to develop on real devices or emulators.

LiftLog is split up into a couple of different dotnet projects:

Frontend

LiftLog.Ui is where the majority of the application is developed. It is a blazor class library which contains all of the components and pages for the app. We use Fluxor to manage state, and attempt to keep many components as dumb presentation components, without direct access to this state.

There are several services which are defined and used by LiftLog.Ui, some of which are platform specific. In these cases an interface is defined for the service for the relevant platform project to implement. INotificationService is a good example of this, where richer notifications can be created on applications vs the web.

LiftLog.Web is a Blazor Webassembly application which can be used for local development. It implements the required services which are defined in LiftLog.Ui to run in a web environment. While this is useful for development, new features should be tested on emulated and real devices before release, as there are some differences between the webassembly runtime and the MAUI runtime.

LiftLog.Maui is a MAUI application utilizing a BlazorWebView to display the UI defined in LiftLog.Ui. It implements the specific services required for running the UI on an iOS or Android device. This is the application which is published to the relevant app store.

Backend

This project contains a dotnet webapi backend for LiftLog. It is in charge of storing, and serving feeds to people, however it has no knowledge of the content of feeds, aside from timestamps and user IDs. Feeds are end to end encrypted using a shared symmetric key via AES.

It also handles the AI generated plans with OpenAI.

The site folder contains the source for the website at liftlog.online, along with the privacy policy etc.

Stats

Star History Chart