Koffan releases

What's Changed

• Add Italian locale by @Haxonium in https://github.com/PanSalut/Koffan/pull/119

New Contributors

• @Haxonium made their first contribution in https://github.com/PanSalut/Koffan/pull/119

Full Changelog: https://github.com/PanSalut/Koffan/compare/v2.10.0...v2.11.0

Full Changelog: https://github.com/PanSalut/Koffan/compare/v2.9.0...v2.10.0

Full Changelog: https://github.com/PanSalut/Koffan/compare/v2.8.1...v2.9.0

Full Changelog: https://github.com/PanSalut/Koffan/compare/v2.8.0...v2.8.1

Full Changelog: https://github.com/PanSalut/Koffan/compare/v2.6.2...v2.8.0

What's Changed

• feat:Add Chinese (Simplified) language support to i18n by @libashanxi in https://github.com/PanSalut/Koffan/pull/113

New Contributors

• @libashanxi made their first contribution in https://github.com/PanSalut/Koffan/pull/113

Full Changelog: https://github.com/PanSalut/Koffan/compare/v2.6.2...v2.7.0

What's Changed

• Feature: add crossorigin="use-credentials" to manifest for PWA support behind proxies by @derfloDev in https://github.com/PanSalut/Koffan/pull/115

New Contributors

• @derfloDev made their first contribution in https://github.com/PanSalut/Koffan/pull/115

Full Changelog: https://github.com/PanSalut/Koffan/compare/v2.6.1...v2.6.2

Full Changelog: https://github.com/PanSalut/Koffan/compare/v2.6.0...v2.6.1

What's Changed

• new Feature: hide bought items by @sir-andreas in https://github.com/PanSalut/Koffan/pull/103

New Contributors

• @sir-andreas made their first contribution in https://github.com/PanSalut/Koffan/pull/103

Full Changelog: https://github.com/PanSalut/Koffan/compare/v2.5.0...v2.6.0

What's Changed

• Fixed some issues by @bretonjustin in https://github.com/PanSalut/Koffan/pull/104

Full Changelog: https://github.com/PanSalut/Koffan/compare/v2.4.0...v2.5.0

What's Changed

• Create Czech localization file cs.json by @Dvorinka in https://github.com/PanSalut/Koffan/pull/106
• added dutch / flemish language by @FrumbleFrommel in https://github.com/PanSalut/Koffan/pull/107

New Contributors

• @Dvorinka made their first contribution in https://github.com/PanSalut/Koffan/pull/106
• @FrumbleFrommel made their first contribution in https://github.com/PanSalut/Koffan/pull/107

Full Changelog: https://github.com/PanSalut/Koffan/compare/v2.3.1...v2.4.0

What's Changed

• Fixed Typos by @AminGholizad in https://github.com/PanSalut/Koffan/pull/100

Full Changelog: https://github.com/PanSalut/Koffan/compare/v2.3.0...v2.3.1

Full Changelog: https://github.com/PanSalut/Koffan/compare/v2.2.0...v2.3.0

What's Changed

• Fix the issue where list items do not refresh when browser is hidden by @bretonjustin in https://github.com/PanSalut/Koffan/pull/95
• added Farsi translations by @AminGholizad in https://github.com/PanSalut/Koffan/pull/91

New Contributors

• @bretonjustin made their first contribution in https://github.com/PanSalut/Koffan/pull/95
• @AminGholizad made their first contribution in https://github.com/PanSalut/Koffan/pull/91

Full Changelog: https://github.com/PanSalut/Koffan/compare/v2.1.1...v2.2.0

Full Changelog: https://github.com/PanSalut/Koffan/compare/v2.1.0...v2.1.1

Full Changelog: https://github.com/PanSalut/Koffan/compare/v2.0.0...v2.1.0

Full Changelog: https://github.com/PanSalut/Koffan/compare/v1.9.2...v2.0.0

What's Changed

• Add Russian language by @unuunn in https://github.com/PanSalut/Koffan/pull/76

New Contributors

• @unuunn made their first contribution in https://github.com/PanSalut/Koffan/pull/76

Full Changelog: https://github.com/PanSalut/Koffan/compare/v1.9.1...v1.9.2

Full Changelog: https://github.com/PanSalut/Koffan/compare/v1.9.0...v1.9.1

Full Changelog: https://github.com/PanSalut/Koffan/compare/v1.8.2...v1.9.0

What's Changed

• Fix Service Worker path by @JenswBE in https://github.com/PanSalut/Koffan/pull/68

New Contributors

• @JenswBE made their first contribution in https://github.com/PanSalut/Koffan/pull/68

Full Changelog: https://github.com/PanSalut/Koffan/compare/v1.8.1...v1.8.2

Full Changelog: https://github.com/PanSalut/Koffan/compare/v1.8.0...v1.8.1

What's Changed

• Remove copying of templates and static files in Dockerfile by @0alai in https://github.com/PanSalut/Koffan/pull/59

New Contributors

• @0alai made their first contribution in https://github.com/PanSalut/Koffan/pull/59

Full Changelog: https://github.com/PanSalut/Koffan/compare/v1.7.0...v1.8.0

Full Changelog: https://github.com/PanSalut/Koffan/compare/v1.6.9...v1.7.0

What's Changed

• Embed templates and static assets into binary by @ancientcatz in https://github.com/PanSalut/Koffan/pull/54

New Contributors

• @ancientcatz made their first contribution in https://github.com/PanSalut/Koffan/pull/54

Full Changelog: https://github.com/PanSalut/Koffan/compare/v1.6.7...v1.6.9

What's Changed

• fix: apostrophe handling, offline mode improvements by @PanSalut in https://github.com/PanSalut/Koffan/pull/57

New Contributors

• @PanSalut made their first contribution in https://github.com/PanSalut/Koffan/pull/57

Full Changelog: https://github.com/PanSalut/Koffan/compare/v1.6.7...v1.6.8

Full Changelog: https://github.com/PanSalut/Koffan/compare/v1.6.6...v1.6.7

Full Changelog: https://github.com/PanSalut/Koffan/compare/v1.6.5...v1.6.6

Full Changelog: https://github.com/PanSalut/Koffan/compare/v1.6.4...v1.6.5

Full Changelog: https://github.com/PanSalut/Koffan/compare/v1.6.3...v1.6.4

Full Changelog: https://github.com/PanSalut/Koffan/compare/1.6.2...v1.6.3

What's New

Import/Export functionality

• Export and import your shopping lists as JSON or CSV
• Full history support - remembers which list and section items were added to
• Conflict resolution options when importing duplicate lists

Other improvements

• Clear database option in Data tab
• Sponsors section added

Closes #6

Added Slovak (SK) translation. Thanks @Richdark for the contribution!

Improvements

• Added 'Add first section' button when no sections exist (#37)
  • Users can now quickly create their first section from the empty state
  • Available in all 11 supported languages

Added Greek language (Ελληνικά) translation.

Bug Fixes

• Fix default list title language - now respects DEFAULT_LANG setting instead of hardcoded Polish (#36)

Changes

• Added docker-compose.local.yaml for local development (#35)
  • Use docker-compose -f docker-compose.local.yaml up -d to run locally
  • Main docker-compose.yaml uses expose for compatibility with Coolify/Dokploy

Changes

• Added docker-compose.local.yaml for local development (#35)
  • Use docker-compose -f docker-compose.local.yaml up -d to run locally
  • Main docker-compose.yaml uses expose for compatibility with Coolify/Dokploy

New Features

• Drag and drop reordering - Reorder items within sections and move items between sections by dragging (Issue #27)
  • Works on mobile with touch support
  • Offline support - changes are queued and synced when back online
  • Haptic feedback on mobile devices

Improvements

• Better UI refresh after offline sync
• Smoother drag animations

Changes

• Improved handling of long list names - names are now dynamically truncated only when they don't fit in the container (#31)

New Features

• Dark mode support - Full dark/light/system theme switching
• New app icons - Fresh cat logo design
• Dark mode scrollbar styling - Consistent look in dark theme

Improvements

• Updated README with dark mode feature showcase
• Polish translation improvements
• Fix race condition in section item handling

New Features

• Swedish translation - Added Swedish (Svenska) language support

Fixes

• Fixed typos in Swedish translation (Snabbinläggning, Pågående, Mallar)

New Languages

• Norwegian (Norsk) - Thanks to @SveinEven (#28)
• Lithuanian (Lietuvių) - Thanks to @mantasio (#29)

Koffan now supports 9 languages: PL, EN, DE, ES, FR, PT, UK, NO, LT

Improvements

• Return 503 when REST API is disabled - When API_TOKEN is not set, API endpoints now return proper 503 Service Unavailable with JSON error response instead of redirecting to login page.

Bug Fixes

• Fix icon validation in REST API - Invalid text input for icons now falls back to default cart emoji (🛒) instead of being stored as plain text. Only valid emoji or known aliases are accepted.

REST API Improvements

• String aliases for icons - Use \"cart\", \"home\", \"gift\" etc. instead of emoji in API requests
• Wiki documentation - Added REST API documentation to GitHub Wiki

See REST API docs for full reference.

New Features

REST API

• Token-based authentication - Enable API by setting API_TOKEN environment variable
• Full CRUD endpoints for lists, sections, and items at /api/v1/
• Batch creation - Create complex structures (list + sections + items) in a single request
• Reordering support - Move items up/down via API
• History/suggestions management - Add, view, and delete item suggestions

API Endpoints

| Resource | Endpoints |
|----------|-----------|
| Lists | GET, POST, PUT, DELETE /api/v1/lists |
| Sections | GET, POST, PUT, DELETE /api/v1/sections |
| Items | GET, POST, PUT, DELETE /api/v1/items |
| Batch | POST /api/v1/batch |
| History | GET, POST, DELETE /api/v1/history |

Usage

# Enable API
export API_TOKEN="your-secure-token"

# Example request
curl -H "Authorization: Bearer your-secure-token" \
  http://localhost:3000/api/v1/lists

Bug Fixes

• Fixed list_id not being returned in section responses

Changes

• Allow deleting any list - Removed restrictions that prevented deleting active or last remaining list
• Renamed "Templates" to "Real-time" - Updated feature label in welcome screen across all 7 languages
• New sync icon - Updated icon to reflect real-time synchronization feature

Bug Fixes

• Fixed empty state visibility - The "No items" message now disappears automatically when adding the first product or section (previously required page refresh)

New Features

• Quick-add button in section headers - Tap the + icon next to any section name to quickly add items to that section
  • On desktop: automatically selects the section and focuses the input field
  • On mobile: opens the add item modal with the section pre-selected
• Improved completed section indicator - Replaced text badge with a clean pink checkmark icon when all items in a section are purchased

Translations

• Added quick_add translation key for all supported languages (EN, PL, DE, FR, ES, PT, UA)

New Features

• Ukrainian localization - Added full Ukrainian language support (contributed by @otolochko)
  • Complete translation of all app features
  • Lists, templates, onboarding, and settings sections included

Fixes

• Fixed CI workflow to only run on public repo

Features

• Multiple lists support - Create and manage multiple shopping lists with custom icons
• Mobile bottom navigation bar - Quick access to lists on mobile devices
• Offline sync with Last Write Wins - Changes made offline are synced when back online, newest change wins
• Empty state for lists - Better UX when list has sections but no products
• Auto-create section - Sections created without page reload

Fixes

• Fix offline sync with proper IndexedDB versioning
• Fix SQLite concurrency issues causing session loss
• Fix session cookie Path attribute
• Fix section reordering race condition
• Fix radio button color to pink

Other

• Remove offline support for lists page (keep for individual list view only)
• Simplify mobile stats display
• Various UI/UX improvements

New Features

• DISABLE_AUTH environment variable - Skip built-in authentication for reverse proxy setups
  • Set DISABLE_AUTH=true to bypass login when your proxy handles auth
  • Useful for Traefik, Caddy, Nginx with Authelia/Authentik, etc.

Closes #14

Changes

• Page title now shows Koffan Shopping List (and localized equivalents)
  • EN: Koffan Shopping List
  • PL: Koffan Lista Zakupów
  • DE: Koffan Einkaufsliste
  • ES: Koffan Lista de compras
  • FR: Koffan Liste de courses
  • PT: Koffan Lista de compras
• Login page title simplified to "Login - Koffan" (localized)

Bug Fixes

• Fixed page title translation (issue #13) - Page title now stays in the selected language after toggling items
• Changed hardcoded Polish <html lang="pl"> to dynamic language based on user preference
• Changed hardcoded Polish title to "Koffan" fallback
• Added htmx:afterRequest handler to ensure title is always restored after HTMX operations

New Features

Auto-completion with fuzzy search

• Start typing a product name to see suggestions from your history
• Fuzzy matching finds products even with typos
• Remembers which section each product was last added to

Product history management

• New section in Settings → Shopping List
• View all saved products with their sections
• Search through history
• Delete items added by mistake

One-click deploy

• Deploy buttons for Railway, Render, DigitalOcean, and Heroku
• Configuration files included for easy self-hosting

Improvements

• Input validation limits to prevent DoS attacks
• Consistent UI styling across the app

Bug Fixes

• Page title translation - Fixed title reverting to "Lista Zakupow" after data sync (push/pull)

New Features

• Delete all bought items - New button in Settings > Shopping list tab to remove all completed items at once
• Settings tabs - Settings modal now has two tabs: Account (language settings) and Shopping list (list management)
• Offline protection - Delete action is blocked when offline

Translations

• Added translations for all 6 supported languages (PL, EN, DE, ES, FR, PT)

New Features

• Mobile FAB Speed Dial menu - Added quick access to section management on mobile devices
  • Tap the floating action button to reveal menu options
  • "Add product" - opens the add item modal
  • "Manage sections" - opens section management modal
  • Smooth animations with button rotation feedback

Notes

• Section management requires internet connection (offline mode not supported)

Bug Fixes

• Fixed login redirect loop on HTTP connections - Session cookie was incorrectly set with Secure flag when APP_ENV=production, which broke authentication when accessing the app via HTTP (e.g., on local network by IP address). Now the Secure flag is set based on actual connection protocol.

Technical Details

• Added isSecureConnection() helper that checks:
  • X-Forwarded-Proto header (for reverse proxy setups)
  • Direct connection protocol
• This ensures cookies work correctly on both HTTP (local network) and HTTPS (behind reverse proxy) setups.

Fixes #1

What's New

• Add more toggle - keep modal open to add multiple items without closing
• Enter to submit - press Enter on name field to quickly add item
• Section stays selected when adding more items
• Translations for all 6 languages

Bug Fixes

• Section counter - Now updates correctly when deleting items
• Empty sections - Automatically hidden when all items are removed
• Bought section state - Fixed persistence of expanded/collapsed state on iOS Safari and after HTMX swaps (#3)

Technical Changes

• Added updateSectionAfterDelete() helper function
• Changed Alpine.js initialization to use init() method for reliable state restoration
• Added getCompletedSectionState() for safe localStorage access on iOS

Zmiany

Nowe funkcje

• Przycisk edycji na desktop view
• Synchronizacja offline z Last Write Wins (najnowsze wygrywa)

Poprawki

• Uproszczona synchronizacja po powrocie online - sync, toast, reload strony
• Naprawiono podwójny toast przy powrocie online
• Naprawiono błędy UI przy edycji offline
• Naprawiono migrację SQLite
• Poprawiono obsługę błędów w GetItemVersion

Added

• Edit button in desktop view - now you can edit items directly from the list on hover

What's Changed

• Add delete confirmation dialog on desktop (matching mobile behavior)

Previously, items were deleted immediately on desktop without confirmation. Now a confirmation dialog appears before deletion, consistent with the mobile experience.

Bug Fixes

• Fixed localization bug - Delete section confirmation popup now displays in the user's selected language instead of always showing Polish (#10)
• Fixed "Postep" label - Progress bar label now uses i18n translations
• Fixed page title - Page title is now dynamically set based on selected language

Languages affected

All 6 supported languages: PL, EN, DE, FR, ES, PT

Security & Stability Fixes

• Fix unchecked crypto/rand error in session ID generation
• Fix XSS vulnerability in mobile action button template
• Fix race conditions in section/item move operations (reads now inside transactions)

Remove unused preferences table from database schema

What's Changed

Bug Fixes

• Fixed default language configuration - The app now defaults to English instead of Polish for new users
• Added DEFAULT_LANG environment variable - You can now configure the default language (e.g., DEFAULT_LANG=de for German)
• Removed unreliable browser language detection - Language is now determined by: user preference (localStorage) → server default

Documentation

• Added DEFAULT_LANG to environment variables documentation in README
• Translated i18n/README.md to English

Fixes #2

Mobile UX Improvements

Pull to Refresh

• Added native-feeling pull-to-refresh gesture on mobile
• Spinner follows your finger position smoothly
• Triggers refresh after ~70px pull threshold

Zoom Prevention

• Disabled pinch zoom and double-tap zoom on mobile
• Fixed iOS auto-zoom when focusing on input fields (font-size 16px fix)
• Added touch-action: manipulation for better touch handling

Smooth Refresh Animation

• Added overlay fade animation during page refresh
• Debounced refresh calls to prevent multiple rapid updates
• Eliminated page "flashing" during content swap

Default Section Selection

• First section is now auto-selected when adding items
• Removed empty "Select section" placeholder option

Offline Support Enhancements

• Toast notifications for offline action feedback
• Optimistic UI updates for toggle and edit actions
• Visual sync badges on pending items (rose color scheme)
• Improved offline item creation with sync indicators

Koffan v1.0.0

First stable release of the shopping list management app.

Features

• Add, edit and delete items
• Organize items into sections/categories
• Mark items as purchased or uncertain
• Real-time sync via WebSocket
• Responsive mobile-first UI
• Simple password authentication
• SQLite database with persistent storage
• Docker & Coolify ready

Deployment

• Docker Compose support
• Coolify deployment instructions included
• Traefik reverse proxy compatible