Release v0.28.0

.env.example

@@ -1,11 +1,17 @@
 # May Configuration
-# Copy this file to .env and update the values
+# Copy this file to .env and update the values.
+# Keep .env next to config.py; it is read when May starts.
+# Variables set in the real environment take precedence over this file.
 
 # Secret key for session encryption (generate a random string for production)
 SECRET_KEY=your-secret-key-here
 
-# Database URL (default: SQLite in data folder)
-# DATABASE_URL=sqlite:///data/may.db
+# Database URL (default: SQLite in the app's own data folder)
+# Uncomment and set an absolute path to move the database elsewhere.
+# Note the slashes: sqlite:///path is relative, sqlite:////path is absolute.
+# DATABASE_URL=sqlite:////absolute/path/to/may/data/may.db
+# PostgreSQL is also supported:
+# DATABASE_URL=postgresql://user:password@host:5432/may
 
-# Upload folder for attachments
-# UPLOAD_FOLDER=/app/data/uploads
+# Upload folder for attachments (default: the app's own data/uploads folder)
+# UPLOAD_FOLDER=/absolute/path/to/may/data/uploads

.github/workflows/docker.yml

@@ -20,7 +20,7 @@ jobs:
         uses: actions/checkout@v7
 
       - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@v7
         with:
           python-version: '3.12'
           cache: 'pip'

CHANGELOG.md

@@ -0,0 +1,59 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+This file starts at 0.28.0. Notes for earlier releases are on the
+[GitHub releases page](https://github.com/dannymcc/may/releases).
+
+## [0.28.0] - 2026-08-23
+
+### Added
+
+- Vehicle PDF reports can now include receipt images. The vehicle page has a
+  "PDF + Receipts" button alongside the existing "PDF" one; it appends the
+  images attached to the fuel logs and expenses in the report. Anything that
+  cannot be inlined — a PDF scan, a missing file, or one that would push the
+  report past the 20 MB image budget — is listed at the end of the report
+  rather than dropped silently.
+  ([#219](https://github.com/dannymcc/may/issues/219))
+- Expenses accept more than one receipt. Select several files when adding or
+  editing an expense, and the expandable row in the expense list links to each
+  one. Files rejected for an unsupported extension are now reported rather than
+  dropped silently. ([#234](https://github.com/dannymcc/may/issues/234))
+- API v1 endpoints for trips and charging sessions: list, create, read, update
+  and delete under `/api/v1/vehicles/{id}/trips`, `/api/v1/trips/{id}`,
+  `/api/v1/vehicles/{id}/charging` and `/api/v1/charging/{id}`, plus
+  `/api/v1/trip-purposes` and `/api/v1/charger-types`. Documented at `/api/docs`.
+  ([#295](https://github.com/dannymcc/may/issues/295))
+- Dashboard charts label their value axis with your currency, and tooltips show
+  it too. ([#289](https://github.com/dannymcc/may/issues/289))
+- Initial Hungarian translation files, contributed by
+  [@burgatshow](https://github.com/burgatshow). Hungarian is not yet offered in
+  the language picker while the remaining strings are filled in.
+  ([#290](https://github.com/dannymcc/may/pull/290))
+
+### Fixed
+
+- `.env` settings were silently ignored. `config.py` now loads the `.env` file
+  sitting next to it before reading the environment. Real environment variables
+  still take precedence, so Docker deployments are unaffected.
+  ([#297](https://github.com/dannymcc/may/issues/297))
+- Deleting an entry from the fuel log bounced you to the vehicle page; it now
+  leaves you where you were. ([#298](https://github.com/dannymcc/may/issues/298))
+
+### Changed
+
+- The expense list loads attachments in a single query rather than one per row.
+- README and `.env.example` corrected: the real defaults for `DATABASE_URL` and
+  `UPLOAD_FOLDER` are inside the application directory, the `sqlite:///` versus
+  `sqlite:////` distinction is spelled out, and there is a note that `.env` does
+  not drive those two keys under Docker Compose.
+- The supported languages table in the README now lists Arabic, Czech, Russian
+  and Turkish, which were already available in the app.
+- Dependencies: `psycopg2-binary` >= 2.9.12
+  ([#280](https://github.com/dannymcc/may/pull/280)), `coverage` >= 7.15.4
+  ([#288](https://github.com/dannymcc/may/pull/288)), and `actions/setup-python`
+  bumped from 6 to 7 in CI ([#263](https://github.com/dannymcc/may/pull/263)).

CLAUDE.md

@@ -108,7 +108,7 @@ Migrations run automatically on container startup via the entrypoint script.
 
 ### GitHub Actions Workflow
 
-The project uses GitHub Actions (`.github/workflows/docker-build.yml`) to automatically build and push Docker images:
+The project uses GitHub Actions (`.github/workflows/docker.yml`) to automatically build and push Docker images:
 
 1. On push to `main`, `dev`, or new tags, the workflow triggers
 2. Builds a multi-platform Docker image (linux/amd64, linux/arm64)
@@ -117,7 +117,7 @@ The project uses GitHub Actions (`.github/workflows/docker-build.yml`) to automa
 
 ### Creating a Release
 
-1. Update `APP_VERSION` in `config.py`
+1. Update `APP_VERSION` in `config.py` and add the release section to `CHANGELOG.md`
 2. Commit the version bump to `dev`
 3. Create a pull request from `dev` to `main` with comprehensive changelog
 4. Merge the PR to `main`

README.md

@@ -37,7 +37,7 @@ Named after James May, completing the trio of Top Gear presenters (alongside [Cl
 - **👥 Multi-User**: Share vehicles between family members or team members
 - **📊 Analytics Dashboard**: View spending trends and consumption statistics with interactive charts
 - **📎 Attachment Support**: Upload receipts and documents to fuel logs and expenses
-- **📄 PDF Reports**: Generate comprehensive vehicle reports for record-keeping
+- **📄 PDF Reports**: Generate comprehensive vehicle reports for record-keeping, optionally with receipt images attached
 - **🔧 Customizable Units**: Support for metric/imperial, multiple currencies
 - **🎛️ Menu Customization**: Show/hide menu items and set your preferred start page
 - **🌍 Internationalization**: Available in multiple languages (English, German, Spanish, French, and more)
@@ -128,22 +128,32 @@ Copy `.env.example` to `.env` and configure:
 # Secret key for session encryption
 SECRET_KEY=your-secure-random-string
 
-# Database location (default: SQLite)
-DATABASE_URL=sqlite:///data/may.db
+# Database location (optional, defaults to SQLite in the app's data folder)
+# Note the slashes: sqlite:///path is relative, sqlite:////path is absolute.
+DATABASE_URL=sqlite:////srv/may/data/may.db
 # PostgreSQL is also supported:
 # DATABASE_URL=postgresql://user:password@host:5432/may
 
-# Upload folder for attachments
-UPLOAD_FOLDER=/app/data/uploads
+# Upload folder for attachments (optional)
+UPLOAD_FOLDER=/srv/may/data/uploads
 ```
 
+The `.env` file must sit next to `config.py` in the application directory, and
+it is read when May starts. Variables set in the real environment take
+precedence over `.env`.
+
+Under Docker Compose, `.env` is only used for `${VAR}` substitution in
+`docker-compose.yml` (for example `SECRET_KEY`). `DATABASE_URL` and
+`UPLOAD_FOLDER` are set in the compose `environment:` block, so changing them
+in `.env` has no effect — edit `docker-compose.yml` instead.
+
 ### Environment Variables
 
 | Variable | Description | Default |
 |----------|-------------|---------|
 | `SECRET_KEY` | Session encryption key | Random |
-| `DATABASE_URL` | Database connection string (SQLite or PostgreSQL) | `sqlite:///data/may.db` |
-| `UPLOAD_FOLDER` | Path for file uploads | `/app/data/uploads` |
+| `DATABASE_URL` | Database connection string (SQLite or PostgreSQL) | SQLite at `data/may.db` inside the application directory (`/app/data/may.db` in Docker) |
+| `UPLOAD_FOLDER` | Path for file uploads | `data/uploads` inside the application directory (`/app/data/uploads` in Docker) |
 | `PUID` | User ID the container runs as (linuxserver.io convention) | `1000` |
 | `PGID` | Group ID the container runs as (linuxserver.io convention) | `1000` |
 | `TAILWIND_ASSET_URL` | Local Tailwind Play CDN JS path | `/static/vendor/tailwindcss.js` |
@@ -170,6 +180,7 @@ Add and manage your vehicles with detailed information:
 - **Vehicle Sharing**: Mark a vehicle as "Shared" to make it visible and loggable by all users on the instance
 - **Upcoming Maintenance**: Vehicle detail pages show a live panel of scheduled maintenance tasks, with overdue and due-soon alerts
 - **Parts & Consumables**: Collapsible section on the vehicle page remembers your expand/collapse preference per vehicle
+- **PDF Report**: The "PDF" button downloads a summary of the vehicle, its fuel logs and its expenses. "PDF + Receipts" does the same and appends the receipt images attached to those entries, which is the version to hand to an accountant or employer. Non-image attachments (PDF scans, for example) are listed at the end of the report rather than embedded.
 
 ### Fuel Logs
 Track every fill-up with:
@@ -188,7 +199,7 @@ Categorize all vehicle-related costs:
 - Accessories
 - Other expenses
 
-Record odometer readings alongside costs, and expand any expense row to see vendor and notes details inline.
+Record odometer readings alongside costs, and expand any expense row to see vendor, notes, and links to any attached receipts inline. An expense can have several receipts — select more than one file when adding or editing it.
 
 ### Reminders
 Never miss important dates:
@@ -253,7 +264,8 @@ curl -H "Authorization: Bearer may_your_api_key" \
   http://localhost:5050/api/v1/vehicles
 ```
 
-See the API documentation at `/api/docs` when logged in.
+Vehicles, fuel logs, expenses, trips, and charging sessions can all be read and
+created through the API. See the API documentation at `/api/docs` when logged in.
 
 ## 🔗 Integrations
 
@@ -294,14 +306,16 @@ May is available in the following languages:
 
 | Language | Code | Language | Code |
 |----------|------|----------|------|
-| English | `en` | Swedish | `sv` |
+| English | `en` | Swedish (Svenska) | `sv` |
 | German (Deutsch) | `de` | Danish (Dansk) | `da` |
 | Spanish (Español) | `es` | Norwegian (Norsk) | `no` |
 | French (Français) | `fr` | Finnish (Suomi) | `fi` |
 | Italian (Italiano) | `it` | Japanese (日本語) | `ja` |
 | Dutch (Nederlands) | `nl` | Chinese (中文) | `zh` |
 | Portuguese (Português) | `pt` | Korean (한국어) | `ko` |
-| Polish (Polski) | `pl` | | |
+| Polish (Polski) | `pl` | Czech (Čeština) | `cs` |
+| Russian (Русский) | `ru` | Turkish (Türkçe) | `tr` |
+| Arabic (العربية) | `ar` | | |
 
 You can change your language in **Settings > Units & Values > Language**.