Skip to content

Releases: CodeWithCJ/SparkyFitness

v0.17.2

23 Jun 12:49
dbebd08

Choose a tag to compare

⚠️ Backup before upgrading.
If you do not see the latest updates, please refresh the page or clear your browser cache.

⚠️ SparkyFitnessMCP dedicated container is deprecated.
ChatBot will automatically connect to MCP if the AI service is configured.
MCP is now served directly from the /mcp endpoint, for example: domain.com/mcp.
Use this endpoint for external tools such as n8n, OpenClaw, and similar integrations.
The dedicated SparkyFitnessMCP container is still available from the previous release, but it will be removed in the upcoming release.

⚠️ Fitbit API is being replaced.
As Google is decommissioning the Fitbit API, it is being replaced with the Google Health API.
Fitbit support will be removed once decommissioning is complete.

⚠️ Use caution with write-back functionality.
Write-back support for Apple Health and Google Health is part of an initial release.
This feature may require multiple iterations before it becomes fully stable.

⚠️ Though you don't need to immediately upgrade, in the upcoming months the Postgres upgrade will be mandated.
Have caution. Below guide might have flaws. Research yourself before performing the upgrade. Some funcationality like auto backup within SparkyFitness will not work if you don't upgrade.

https://codewithcj.github.io/SparkyFitness/install/postgres-upgrade

💙 Support SparkyFitness

Support development if you find SparkyFitness useful — There is approximately $99 in remaining project expenses from mac mini, apple & google fees.

What's Changed

Fixes

Full Changelog: v0.17.1...v0.17.2

v0.17.1

23 Jun 02:31
71274d7

Choose a tag to compare

BREAKING CHANGE - MUST READ BELOW

⚠️ Backup before upgrading.
If you do not see the latest updates, please refresh the page or clear your browser cache.

⚠️ SparkyFitnessMCP dedicated container is deprecated.
ChatBot will automatically connect to MCP if the AI service is configured.
MCP is now served directly from the /mcp endpoint, for example: domain.com/mcp.
Use this endpoint for external tools such as n8n, OpenClaw, and similar integrations.
The dedicated SparkyFitnessMCP container is still available from the previous release, but it will be removed in the upcoming release.

⚠️ Fitbit API is being replaced.
As Google is decommissioning the Fitbit API, it is being replaced with the Google Health API.
Fitbit support will be removed once decommissioning is complete.

⚠️ Use caution with write-back functionality.
Write-back support for Apple Health and Google Health is part of an initial release.
This feature may require multiple iterations before it becomes fully stable.

⚠️ Though you don't need to immediately upgrade, in the upcoming months the Postgres upgrade will be mandated.
Have caution. Below guide might have flaws. Research yourself before performing the upgrade. Some funcationality like auto backup within SparkyFitness will not work if you don't upgrade.

https://codewithcj.github.io/SparkyFitness/install/postgres-upgrade

💙 Support SparkyFitness

Support development if you find SparkyFitness useful — There is approximately $99 in remaining project expenses from mac mini, apple & google fees.

What's Changed

Features

  • feat: update BMR label to use dynamic health source name by @apedley in #1611

Full Changelog: v0.17.0...v0.17.1

v0.17.0

22 Jun 20:24
408d15f

Choose a tag to compare

BREAKING CHANGE - MUST READ BELOW

⚠️ Backup before upgrading.
If you do not see the latest updates, please refresh the page or clear your browser cache.

⚠️ SparkyFitnessMCP dedicated container is deprecated.
ChatBot will automatically connect to MCP if the AI service is configured.
MCP is now served directly from the /mcp endpoint, for example: domain.com/mcp.
Use this endpoint for external tools such as n8n, OpenClaw, and similar integrations.
The dedicated SparkyFitnessMCP container is still available from the previous release, but it will be removed in the upcoming release.

⚠️ Fitbit API is being replaced.
As Google is decommissioning the Fitbit API, it is being replaced with the Google Health API.
Fitbit support will be removed once decommissioning is complete.

⚠️ Use caution with write-back functionality.
Write-back support for Apple Health and Google Health is part of an initial release.
This feature may require multiple iterations before it becomes fully stable.

⚠️ Though you don't need to immediately upgrade, in the upcoming months the Postgres upgrade will be mandated.
Have caution. Below guide might have flaws. Research yourself before performing the upgrade. Some funcationality like auto backup within SparkyFitness will not work if you don't upgrade.

https://codewithcj.github.io/SparkyFitness/install/postgres-upgrade

💙 Support SparkyFitness

Support development if you find SparkyFitness useful — There is approximately $99 in remaining project expenses from mac mini, apple & google fees.

What's Changed

Features

  • feat: add Google Health API integration by @ZeSlammy in #1474
  • feat(mobile): edit ingredients of a logged meal by @jsandai in #1482
  • feat(mobile): YAZIO provider integration - mobile food search, barcode scan and serving display by @thorethy1 in #1480
  • Extend MCP tools for structured food, exercise, goals, and report data by @lev-ok in #1485
  • Mobile Bug fixes + additions by @BryceKrispiess in #1444
  • feat: Add Duplicate action to the food Actions menu by @jsandai in #1511
  • Sync nutrition diary from Garmin Connect + by @gPinato in #1506
  • feat: add outbound proxy support for HTTPS requests by @apedley in #1520
  • feat: Add off-today date cues by @geracobo in #1500
  • feat(health-connect): ingest Android Health Connect nutrition as food entries by @izadiegizabal in #1503
  • Adaptive & Manual Goal mode implementation by @CodeWithCJ in #1519
  • added supported for USDA to import multiple unit type variants by @CodeWithCJ in #1538
  • feat(ai): add exponential backoff for Gemini quota errors (429) by @zeusal in #1549
  • Added ability to copy from/copy to foods & meals from family member. by @CodeWithCJ in #1556
  • Removal of super user extensions in postgres by @CodeWithCJ in #1558
  • feat(web): add barcode manual entry and camera scanning to custom food form by @CodeWithCJ in #1562
  • Import BMR from mobile by @BryceKrispiess in #1521
  • feat: add check-in progress photos (front, back, side) by @zeusal in #1533
  • feat(health-connect): write nutrition & hydration back to Health Connect (Android) by @izadiegizabal in #1529
  • swissfood implementation for mobile app by @CodeWithCJ in #1568
  • Formatted Whats New dialog and also added BREAKING CHANGE warning by @CodeWithCJ in #1573
  • github issue template update and pr transaltion automation from Spark… by @CodeWithCJ in #1578
  • feat: mobile date context improvements by @geracobo in #1526
  • feat(mobile): copy a logged meal to another day by @jsandai in #1574
  • feat: apple health nutrition sync and writeback by @apedley in #1585
  • fix(mobile): send Origin header during login to satisfy better-auth CSRF checks by @CodeWithCJ in #1589
  • feature: Added Global Food & Exercise data provider. by @CodeWithCJ in #1590
  • Mobile Fast Tracking by @apedley in #1598
  • Added ability to view, modify custom nutrients in the food form and food detail screens. by @CodeWithCJ in #1593
  • feat(writeback): remove SparkyFitness data from the OS health store (rollback) by @izadiegizabal in #1599
  • added ability to hide/resize widgets on the diary page by @CodeWithCJ in #1604
  • feat: add exercise water loss to daily goal and activity report stats by @gPinato in #1605
  • Add NixOS module by @dlip in #1602
  • Add NixOS module by @CodeWithCJ in #1609

Fixes

  • fix(mobile): show active calories by @apedley in #1499
  • Keep nutrition fields editable when Auto-Scale is on by @jsandai in #1513
  • fix: DATE column timezone shift by @apedley in #1518
  • fix(measurements): repair DELETE /measurements/check-in/{id} (500 on every delete) by @bamonroe in #1530
  • fix(foods): close Edit Food dialog correctly when cancelling past enrties sync by @CodeWithCJ in #1534
  • fix: support user weight units in active workout playback and preset stats by @CodeWithCJ in #1535
  • Backup setting fixes for web by @BryceKrispiess in #1537
  • Next/prev month buttons on android not showing in dark/Amoled by @BryceKrispiess in #1528
  • Fix zero body measurements from Garmin overwriting valid historical data by @gPinato in #1542
  • Check in error/bug fixes by @BryceKrispiess in #1546
  • split child RLS policies and enforce ownership check on variant deletion by @CodeWithCJ in #1552
  • fix(server): resolve adaptive TDEE overestimation, tighten safety cap to ±500 kcal, and downgrade confidence for young trackers or logging gaps by @CodeWithCJ in #1555
  • Fix garmin nutrition sync data loss by @gPinato in #1544
  • Use adjusted calorie goal for summary and per meal targets by @gPinato in #1543
  • fix(tandoor): handle literal "null" string and malformed source_url in recipe mapping by @CodeWithCJ in #1559
  • fix(mobile): only show updated measurements on diary by @apedley in #1567
  • fix for AI ChatBot using old 50 messages isntead of recent 50 messages. by @CodeWithCJ in #1570
  • fix for missing nutritional value while creating meal via ChatBot by @CodeWithCJ in #1577
  • fix(server): simplify meal retrieval by leveraging RLS for family library sharing by @CodeWithCJ in #1582
  • fix(auth): resolve OIDC group sync, provider endpoint mapping, and client token auth issues by @CodeWithCJ in #1583
  • fix: do not count both active calories and workouts by @apedley in #1588
  • fix(garmin): resolving authentication usage by @dhruvinsh in #1603

Documentation

Other Changes

  • Subtract dietary fiber caloric contribution from calorie target before calculating macro targets by @CodeWithCJ in #1531
  • added pretieer for translation PR workflow by @CodeWithCJ in #1580
  • chore(i18n): sync translations from Weblate by @github-actions[bot] in #1581

New Contributors

Read more

v0.16.9

07 Jun 22:02
b21e399

Choose a tag to compare

BREAKING CHANGE

💙 Support SparkyFitness

Support development if you find SparkyFitness useful — There is approximately $158.58 in remaining project expenses.

⚠️ Important:
⚠️ Backup before upgrading. If you don’t see the latest updates, please refresh or clear your browser cache.
🚀 New providers added: Yazio, Norish & Swish Food Database.

⚠️ If you are using Chatbot in Web, you must configure MCP server. If you had previously setup MCP, you must add below env variables for web Chatbot to work.

Add these under MCP container section.
SPARKY_FITNESS_SERVER_HOST: ${SPARKY_FITNESS_SERVER_HOST:-sparkyfitness-server}
SPARKY_FITNESS_SERVER_PORT: ${SPARKY_FITNESS_SERVER_PORT:-3010}
SPARKY_FITNESS_FRONTEND_URL: ${SPARKY_FITNESS_FRONTEND_URL:-http://0.0.0.0:3004}
You only needs these to be again added to MCP section if you had used these for Server container. Otherwise, you can skip these.
ALLOW_PRIVATE_NETWORK_CORS: ${ALLOW_PRIVATE_NETWORK_CORS:-false}
SPARKY_FITNESS_EXTRA_TRUSTED_ORIGINS: ${SPARKY_FITNESS_EXTRA_TRUSTED_ORIGINS:-}

Refer the updated docker compose as reference if above instruction is not clear.

What's Changed

Features

  • Add update_exercise_entry action to MCP exercise tool by @Sapd in #1428
  • Expose RPE, per-set notes, and cardio fields over the MCP exercise tool by @Sapd in #1430
  • updated api doc to include public accessable and fixed API key auth issue in swagger UI by @CodeWithCJ in #1451
  • Feature/yazio provider 1442 by @thorethy1 in #1458
  • [Feature] Integration with Norish by @CodeWithCJ in #1464
  • norish food provider integration - removal of any declaration by @CodeWithCJ in #1465
  • [Feature]: Allow multiple images per AI food photo estimate by @jsandai in #1409
  • Integration with Swiss Food Database provider by @CodeWithCJ in #1471

Fixes

New Contributors

Full Changelog: v0.16.8...v0.16.9

v0.16.8

01 Jun 02:14
16c72e6

Choose a tag to compare

💙 Support SparkyFitness

Support development if you find SparkyFitness useful — There is $168.58 in remaining project expenses.

⚠️ Important:
⚠️ Backup before upgrading. If you don’t see the latest updates, please refresh or clear your browser cache.
⚠️ Though you don't need to immediately upgrade, in the upcoming months the Postgres upgrade will be mandated.
Have caution. Below guide might have flaws. Research yourself before performing the upgrade.
https://codewithcj.github.io/SparkyFitness/install/postgres-upgrade
⚠️ If you are using Chatbot in Web, you must configure MCP server. If you had previously setup MCP, you must add below env variables for web Chatbot to work.

Add these under MCP container section.
SPARKY_FITNESS_SERVER_HOST: ${SPARKY_FITNESS_SERVER_HOST:-sparkyfitness-server}
SPARKY_FITNESS_SERVER_PORT: ${SPARKY_FITNESS_SERVER_PORT:-3010}
SPARKY_FITNESS_FRONTEND_URL: ${SPARKY_FITNESS_FRONTEND_URL:-http://0.0.0.0:3004}
You only needs these to be again added to MCP section if you had used these for Server container. Otherwise, you can skip these.
ALLOW_PRIVATE_NETWORK_CORS: ${ALLOW_PRIVATE_NETWORK_CORS:-false}
SPARKY_FITNESS_EXTRA_TRUSTED_ORIGINS: ${SPARKY_FITNESS_EXTRA_TRUSTED_ORIGINS:-}

Refer the updated docker compose as reference if above instruction is not clear.

What's Changed

Fixes

Full Changelog: v0.16.7...v0.16.8

v0.16.7

31 May 23:56
80ae536

Choose a tag to compare

⚠️ Important:

⚠️ Backup before upgrading. If you don’t see the latest updates, please refresh or clear your browser cache.
⚠️ Though you don't need to immediately upgrade, in the upcoming months the Postgres upgrade will be mandated.
Have caution. Below guide might have flaws. Research yourself before performing the upgrade.
https://codewithcj.github.io/SparkyFitness/install/postgres-upgrade
⚠️ If you are using Chatbot in Web, you must configure MCP server. If you had previously setup MCP, you must add below env variables for web Chatbot to work.

Add these under MCP container section.
SPARKY_FITNESS_SERVER_HOST: ${SPARKY_FITNESS_SERVER_HOST:-sparkyfitness-server}
SPARKY_FITNESS_SERVER_PORT: ${SPARKY_FITNESS_SERVER_PORT:-3010}
SPARKY_FITNESS_FRONTEND_URL: ${SPARKY_FITNESS_FRONTEND_URL:-http://0.0.0.0:3004}
You only needs these to be again added to MCP section if you had used these for Server container. Otherwise, you can skip these.
ALLOW_PRIVATE_NETWORK_CORS: ${ALLOW_PRIVATE_NETWORK_CORS:-false}
SPARKY_FITNESS_EXTRA_TRUSTED_ORIGINS: ${SPARKY_FITNESS_EXTRA_TRUSTED_ORIGINS:-}

Refer the updated docker compose as reference if above instruction is not clear.

What's Changed

Features

Fixes

Documentation

Other Changes

  • Updated bcrypt to bcryptjs and optimized Dockerfile.backend for better speed. by @CodeWithCJ in #1393
  • Delete SparkyFitnessServer/db/migrations/20260527120000_add_allergens… by @CodeWithCJ in #1402

New Contributors

Full Changelog: v0.16.6.3...v0.16.7

v0.16.6.3

24 May 21:43
675c3cf

Choose a tag to compare

⚠️ Backup before upgrading. If you don’t see the latest updates, please refresh or clear your browser cache.
⚠️ Android App – Google Play closed testing URL has changed. Refer to the updated link in the Wiki.
⚠️ Though you don't need to immediately upgrade, in the upcoming months the Postgres upgrade will be mandated.
Have caution. Below guide might have flaws. Research yourself before performing the upgrade.
https://codewithcj.github.io/SparkyFitness/install/postgres-upgrade

💙 Support SparkyFitness

Support development if you find SparkyFitness useful — There is $199.58 in remaining project expenses.

What's Changed

Features

  • feat: food photo estimation by @apedley in #1297
  • feat(mobile): fix exercise session calorie source selection by @apedley in #1299
  • feat: add "Show Net Carbs" preference toggle by @jsandai in #1298
  • feat(mobile): prefill last workout stats and show personal best by @apedley in #1307
  • feat(mobile): add barcode to existing foods by @apedley in #1309
  • feat(mobile): what's new screen by @apedley in #1311
  • feat(onboarding): external food providers and theme updates by @apedley in #1313
  • updated lanague utils for SparkyFitness by @CodeWithCJ in #1315

Fixes

Other Changes

New Contributors

Full Changelog: v0.16.6.2...v0.16.6.3

v0.16.6.2

17 May 23:05
58b0ad4

Choose a tag to compare

⚠️ Backup before upgrading. If you don’t see the latest updates, please refresh or clear your browser cache.
⚠️ Android App – Google Play closed testing URL has changed. Refer to the updated link in the Wiki.
⚠️ Though you don't need to immediately upgrade, in the upcoming months the Postgres upgrade will be mandated.
Have caution. Below guide might have flaws. Research yourself before performing the upgrade.
https://codewithcj.github.io/SparkyFitness/install/postgres-upgrade
⚠️New MCP Server has been added. You can configure SparkyFitnessMCP with your favorite client and interact with SparkyFitness more efficiently.
image

💙 Support SparkyFitness

Support development if you find SparkyFitness useful

What's Changed

Features

Fixes

  • fix(garmin): missing steps, uppercase names, missing categories, duplicate sets by @Sim-sat in #1239
  • make wger import paths relative by @Thovi98 in #1225
  • fix(helm) Working helm chart with many enhancements by @ikogan in #1184
  • fix(mobile): show Start Workout button for workout plan sessions by @G5K-org in #1247
  • fix(server): delete exercise_preset_entries on plan deactivation to prevent duplicates by @G5K-org in #1246
  • fix: Auto-scale and unit conversions by @BryceKrispiess in #1265
  • fix(mobile): add finish button to workout complete banner by @G5K-org in #1245
  • fix(web): adaptive tdee daily energy goal use server calculation by @apedley in #1269
  • Fix(strava): round float average_heartrate before insert by @CodeWithCJ in #1273
  • fix(1264): improve sleep consistency chart's readability by @Sim-sat in #1271
  • fix: revert individual measurement reports removal by @Sim-sat in #1274
  • fix(mobile): app meal managment correct routes by @apedley in #1276
  • docker backend file update fix for postgres version. by @CodeWithCJ in #1277
  • fix(mobile): unlink serving and serving size when creating custom food by @apedley in #1281
  • fix(diary): resolve image persistence, V2 API mapping, and ESM/Windows path resolution issues by @CodeWithCJ in #1282
  • fix(mobile): dark mode tweaks and correct library wording by @apedley in #1288
  • docker postgres version fix by @CodeWithCJ in #1278
  • fix for water intake when no default container exists by @CodeWithCJ in #1285

New Contributors

Full Changelog: v0.16.6.1...v0.16.6.2

v0.16.6.1

05 May 21:57
d5433a7

Choose a tag to compare

⚠️ Backup before upgrading. If you don’t see the latest updates, please refresh or clear your browser cache.
⚠️ Android App – Google Play closed testing URL has changed. Refer to the updated link in the Wiki.
⚠️ Though you don't need to immediately upgrade, in the upcoming months the Postgres upgrade will be mandated.
Have caution. Below guide might have flaws. Research yourself before performing the upgrade.
https://codewithcj.github.io/SparkyFitness/install/postgres-upgrade

💙 Support SparkyFitness

Support development if you find SparkyFitness useful

What's Changed

Fixes

  • fix: crypto.randomUUID is not a function by @Sim-sat in #1227
  • fix: calendar dropdown missing by @Sim-sat in #1228
  • fix(1214): prevent re-presenting AddSheet after dismiss by @apedley in #1231
  • fix: assume decimal for period and comma in number inputs by @apedley in #1232

Full Changelog: v0.16.6.0...v0.16.6.1

v0.16.6.0

30 Apr 05:20
5c1416c

Choose a tag to compare

⚠️ Backup before upgrading. If you don’t see the latest updates, please refresh or clear your browser cache.
⚠️ Android App – Google Play closed testing URL has changed. Refer to the updated link in the Wiki.
⚠️ Though you don't need to immediately upgrade, in the upcoming months the Postgres upgrade will be mandated.
Have caution. Below guide might have flaws. Research yourself before performing the upgrade.
https://codewithcj.github.io/SparkyFitness/install/postgres-upgrade

💙 Support SparkyFitness

Support development if you find SparkyFitness useful

Full Changelog: v0.16.5.9...v0.16.6.0

version fix #1215