Log My Time

Basic time logging tool.

Demo

Screen.Recording.2025-07-11.at.15.16.30.mov

---

Setup

Running with docker

First create the config/app_config.py, then start on http://localhost:4000/ via docker

# Dev mode
docker compose up -d --build app

# Prod mode
docker compose -f docker-compose.yml up -d --build

Install dependencies locally

Requires python 3.12

# Install JS linter
npm install

# Install python
uv python install 3.13

# Install python dependencies
uv venv
uv pip install -r pyproject.toml --all-extras

# Lock dependencies
uv pip compile pyproject.toml -o requirements.txt

Connecting to the database

./tools/ctl sql

Running the tests

# Run all tests
./tools/ctl test

# Or a subset of tests
./tools/ctl test tests/unit/test_calculate_expected_hours.py

Database migrations

docker exec -it log-my-time flask db revision "Description of change"
docker exec -it log-my-time flask db upgrade

Custom Bootstrap CSS

# Bootstrap overrides can be found in scss/custom.scss
# The build.sh command compiles this to app/static/css/bootstrap.css
cd scss
./build.sh

---

Built with

• Flask
• SQLite
• Flask SQLAlchemy
• SQLAlchemy
• Flask Migrate
• Alembic
• Arrow
• Bootstrap 5
• Spacetime