feat: bump to version 1.0.3

This reverts commit afd65d3bcb.

.env

@@ -1,17 +0,0 @@
-### Photon Environment Variables
-PHOTON_PORT=8090
-SHARE_DOMAIN=localhost:8080
-USER_EMAIL=photon@jrdn.dev
-SHARE_URL_SCHEME=http
-DATA_PATH=./data
-
-### Photon Worker Environment Variables
-SCAN_RATE=10
-
-### Database Environment Variables
-MYSQL_HOST=db
-MYSQL_DATABASE=photon
-MYSQL_USER=photon
-MYSQL_PASSWORD=changeme
-MYSQL_ROOT_PASSWORD=pleasechangeme
-

.gitea/issue_template/bug_report.yml

@@ -17,14 +17,12 @@ body:
       label: Version
       description: What version of Photon are you running? You can find this in the footer of the app.
       options:
-        - 0.1.1 (Latest)
-        - 0.1.0
-        - 0.0.9
-        - 0.0.8
+        - 1.0.0
+        - 0.1.4
     validations:
       required: true
   - type: markdown
     attributes:
       value: |
         This issue was created using the bug report template.
-    visible: [content]
+    visible: [content]

.gitea/issue_template/config.yml

@@ -1 +1 @@
-blank_issues_enabled: false
+blank_issues_enabled: true

.gitea/issue_template/enhancement.yml

@@ -1,7 +1,7 @@
 name: Enhancement Request
 about: Suggest a way things could be improved
-title: "[Feature] ..."
-labels: "Kind/Feature"
+title: "[Enhancement] ..."
+labels: "Kind/Enhancement"
 body:
   - type: textarea
     id: idea
@@ -17,14 +17,12 @@ body:
       label: Version
       description: What version of Photon are you running? You can find this in the footer of the app.
       options:
-        - 0.1.1 (Latest)
-        - 0.1.0
-        - 0.0.9
-        - 0.0.8
+        - 1.0.0
+        - 0.1.4
     validations:
       required: true
   - type: markdown
     attributes:
       value: |
         This issue was created using the feature template.
-    visible: [content]
+    visible: [content]

.gitea/issue_template/feature.yml

@@ -17,14 +17,12 @@ body:
       label: Version
       description: What version of Photon are you running? You can find this in the footer of the app.
       options:
-        - 0.1.1 (Latest)
-        - 0.1.0
-        - 0.0.9
-        - 0.0.8
+        - 1.0.0
+        - 0.1.4
     validations:
       required: true
   - type: markdown
     attributes:
       value: |
         This issue was created using the feature template.
-    visible: [content]
+    visible: [content]

README.md

@@ -1,9 +1,103 @@
 # Photon Screenshot Dashboard
 
-The PHP Screenshot Management Dashboard
+![Photon Logo](/logo.png)
 
-To deploy Photon, use the included `docker-compose-example.yml`.
+![Version](https://img.shields.io/badge/version-v1.0.3-success)
+![Docker](https://img.shields.io/badge/docker-grey?logo=docker)
 
-Ensure you have a data folder that contains your screenshots. Current supported mimetypes are `JPG`, `PNG`, `GIF` and `MP4`.
+A modern, self-hosted PHP screenshot and media management dashboard with powerful organization features, sharing capabilities, and a clean web interface.
 
-You can find the container image history [here](https://git.jrdn.dev/jordanwalster/-/packages/container/photon-dashboard/versions).
+The project consists of three main components:
+
+1. **Photon Dashboard** (`photon`): Web interface for managing screenshots.
+2. **Photon Worker** (`worker`): Background processes (OCR and thumbnail generation).
+3. **MariaDB Database** (`db`): Stores metadata and application data.
+
+Keep up-to-date on new releases by following the [changelog](./changelog.md).
+
+## Features
+
+- **Smart Organization**: Organize screenshots with folders and tags.
+- **Advanced Search**: Find images quickly by name or content using OCR.
+- **Easy Sharing**: Built-in public sharing URLs.
+- **Media Support**: JPG, PNG, GIF, and MP4 (experimental) file support.
+- **Bulk Operations**: Select and manage multiple files at once.
+- **Sorting Options**: Sort by date, size, or filename.
+- **Trash Management**: Safe deletion with trash functionality.
+- **Background Processing**: Dedicated worker for compression and OCR processing.
+- **Database Storage**: MariaDB backend for reliable data persistence.
+
+An external authentication proxy is recommended to protect your dashboard from unwanted eyes.
+
+## Quick Start
+
+1. **Clone the repository**
+   ```bash
+   git clone <repository-url>
+   cd photon-dashboard
+   ```
+
+2. **Configure environment**
+   ```bash
+   cp .env.example .env
+   # Edit .env with your settings
+   ```
+
+3. **Create data directory**
+   ```bash
+   mkdir data
+   # Copy your screenshots to ./data/
+   ```
+
+4. **Deploy with Docker Compose**
+   ```bash
+   docker-compose -f examples/compose-default.yml up -d
+   ```
+
+5. **Access the dashboard**
+   - Open http://localhost:8090 in your browser
+
+## Configuration
+
+### Deployment Options
+
+#### Standard Deployment
+Use `examples/compose-default.yml` for simple deployments:
+```bash
+docker-compose -f examples/compose-default.yml up -d
+```
+
+#### Traefik – Custom Domains
+Use `examples/compose-traefik.yml` for reverse proxy setups, authentication and custom domains. 
+
+## Project Structure
+
+```
+photon-dashboard/
+├── examples/
+│   ├── compose-default.yml    # Default example for basic usage.
+│   ├── compose-traefik.yml    # Traefik example for custom domain routing.
+│   └── .env.example           # Environment configuration
+│
+└── changelog.md               # Version history
+```
+
+## Updates
+
+Container images are available at:
+- Dashboard: `git.jrdn.dev/photon/photon-dashboard:latest`
+- Worker: `git.jrdn.dev/photon/photon-worker:latest`
+
+View version history: [Container Registry](https://git.jrdn.dev/jordanwalster/-/packages/container/photon-dashboard/versions)
+
+### Logs
+```bash
+# View photon logs
+docker logs photon_dashboard
+
+# View worker logs  
+docker logs photon_worker
+
+# View database logs
+docker logs photon_db
+```

changelog.md

@@ -2,6 +2,159 @@
 
 All notable changes to this project will be documented in this file.
 
+## [v1.0.3] - 2026-05-02
+
+### Added
+- Private Sidebar button for easier viewing of images set to private.
+- Make private button to multi-select actions.
+- Download button to multi-select actions.
+- Hold shift to select.
+- Select all (on page) button.
+- New version available message in footer.
+- Generate thumbnail endpoint. 
+- Feedback button to footer.
+
+### Changed
+- Updated icon library to latest.
+- Upgraded to PHP 8.5.
+- Icon for active tags now shows a tag (due to icon library updates).
+- Moved changelog link into version number.
+
+### Fixed
+- Bug where images with capitalised extensions could not be trashed by using "Empty trash" button.
+
+## [v1.0.2] - 2026-05-01
+
+### Added
+- Counter when force generating thumbnails.
+- Context menu for folders in the sidebar (rename and delete actions).
+- Confirm permanently delete popups.
+- Restore database backup tool to recover OCR and tags.
+
+### Fixed
+- Database export includes numeric array indices as column names, corrupting the backup.
+- OCR results not showing within folder context.
+- OCR results not showing for images in folders from within a tag context.
+
+## [v1.0.1] - 2026-04-30
+
+### Added
+- Clear search function on page type switch.
+- Remove tags and Move Folder options to Actions dropdown when searching.
+
+### Changed
+- Image caching now has a time limit and processing is limited to 50 items at a time to prevent resource exhaustion.
+- Colours in actions dropdown more muted.
+
+### Fixed
+- Missing protocol on copy to clipboard.
+- Space handling on next page when using folders.
+- Space handling when using search in folders.
+- Database doesn't update structure when attempting to make an image private.
+- Attempted database update when images don't yet exist in the table.
+- Restore & Permanently delete selected buttons not working.
+
+## [v1.0.0] - 2026-04-30
+
+> [!CAUTION]  
+> The nginx web container has been removed, share links now default to `/share/example.jpg`. To use custom domains please refer to the `examples/compose-traefik.yml` example.
+
+### Added
+- Selected images counter.
+- Sharing endpoint in photon container.
+- Deselect all button.
+- Active page indicator for tag pages.
+- Context menu for image interactions.
+- File metadata inside context menu.
+- Context menu for tags in the sidebar (rename and delete actions).
+- Sorting for images (date, size and name).
+- Selection across multiple pages at a time for better management.
+- Sticky pagination bar, prevents moving when item count is lower between pages.
+- Ability to make images private, links will only work with a valid session.
+- Favicon and logo to footer.
+- Better backend reporting for uploads.
+- New compose files for updated deployments.
+- Ability to move items between folders.
+- Animations on hover.
+- GitHub button in footer linking to project.
+
+### Changed
+- Environment variables `ADMIN_DOMAIN` and `SHARE_DOMAIN` replaced with `PHOTON_DOMAIN` and `PHOTON_SHARE_DOMAIN`.
+- Search now acts as a filter on a given page context.
+- File names now only available in the context menu.
+- Image selection highlights border, shrinks and darkens image.
+- Images now have rounded corners to match the design language.
+- Compression now limits image dimensions to further decrease storage consumption.
+- Backup file name now contains timestamp.
+- Simplified backend functions for easier maintainability.
+- Upload limits have been raised for mass-uploading.
+
+### Fixed
+- Screenshots with special characters in the name cannot be selected by clicking.
+- Restoring a file from trash will always go back to root folder regardless of original source.
+- Image does not scale correctly when changing column count.
+- Assigning tags after first page redirects you to the start.
+- Renaming an image results in tags being lost - resulting in orphaned attachments.
+- Renaming an image results in thumbnails being regenerated and creating duplicates. 
+- 'All Screenshots' in sidebar doesn't show subfolder count.
+- Going to a folder by link doesn't show it as active in the sidebar
+- Image counter for folders doesn't update on upload.
+- Uploading an image with the same name as existing will replace it without confirmation.
+- Image counters don't update on deletion.
+- Newly created tags do not show up in the delete menu until a full-page refresh has occurred.
+- Delete tag dropdown doesn't dynamically update if a tag has been deleted.
+
+### Removed
+- Autocompletion on rename form for previously entered names.
+- Secondary web container.
+- Option for two columns.
+- Menu button on images.
+- URL scheme settings.
+- Checkbox on images.
+- SQLite to MySQL migration tool.
+
+## [v0.1.4] - 2026-04-24
+
+> [!TIP]
+> Web container is being removed in the next update, update your compose files on the next update.
+
+### Added
+- Folders for better file management, items in folders can also have tags.
+- Ability to untag selected images instead of removing tags one at a time.
+
+### Changed
+- Upload destination can now be selected when there are new folders.
+
+### Fixed
+- Bug where pagination would display pages that don't exist.
+
+## [v0.1.3] - 2025-05-03
+
+### Added
+- Upload button for uploading via web dashboard.
+
+### Changed
+- Column dropdown is now a button that switches between options.
+- Some old icons have been switched to FontAwesome icons.
+- Sidebar remaining open flag is now set by a cookie instead of a session token.
+
+### Fixed
+- Page refresh loop when changing column count.
+- Scrollbar failing to show after page content changes.
+- Bug where images with capitalised file extensions do not appear in the grid.
+- Unable to use multi select actions on images with spaces in their names.
+
+### Removed
+- `TAGS_ENABLED`, `SEARCH_ENABLED` and `TRASH_ENABLED` environment variables, these are now permanently enabled.
+
+## [v0.1.2] - 2025-04-29
+
+> [!WARNING]  
+> This introduces a breaking change that requires the latest version of the photon-worker container image.
+
+### Added
+- Image compression worker function, decreasing page load times.
+
 ## [v0.1.1] - 2025-04-28
 
 ### Fixed
@@ -41,10 +194,10 @@ All notable changes to this project will be documented in this file.
 
 ## [v0.0.9] - 2025-04-21
 
-### Fixed
-- Occasional redirection to a previous page when deleting or restoring images.
-- Assign tags field remembers existing tags.
-- Allowing removal of tags from an image.
+### Added
+- Introduced search functionality.
+- Rename tag button.
+- Restore all button for trashed images.
 
 ### Changed
 - Pages no longer use query strings and instead use paths.
@@ -53,10 +206,10 @@ All notable changes to this project will be documented in this file.
 - File format shown in badge.
 - Links are now path based instead of query string based.
 
-### Added
-- Introduced search functionality.
-- Rename tag button.
-- Restore all button for trashed images.
+### Fixed
+- Occasional redirection to a previous page when deleting or restoring images.
+- Assign tags field remembers existing tags.
+- Allowing removal of tags from an image.
 
 ## [v0.0.8] - 2025-01-30
 

examples/.env.example

@@ -0,0 +1,25 @@
+### Photon Environment Variables
+PHOTON_PORT=8090
+USER_EMAIL=photon@jrdn.dev
+DATA_PATH=./data
+
+### Domain Options
+PHOTON_DOMAIN=photon.local
+
+# Uncomment the below lines if you are using a custom subdomain for link sharing.
+# PHOTON_SHARE_DOMAIN=share.photon.local
+# COOKIE_DOMAIN=.photon.local
+
+### Basic Auth Credentials (for Traefik) Use htpasswd to generate the password hash.
+BASIC_AUTH_USER=admin
+BASIC_AUTH_PASSWORD='$apr1$LbKLWjeg$i69pFbEbwQ61CtsjWGq/D0'
+
+### Photon Worker Environment Variables
+SCAN_RATE=10
+
+### Database Environment Variables
+MYSQL_HOST=db
+MYSQL_DATABASE=photon
+MYSQL_USER=photon
+MYSQL_PASSWORD=changeme
+MYSQL_ROOT_PASSWORD=pleasechangeme

examples/compose-default.yml

@@ -13,13 +13,6 @@ services:
       - ${PHOTON_PORT:-8090}:80
     env_file:
       - .env
-  web:
-    container_name: public_web
-    image: nginx
-    ports:
-      - 8080:80
-    volumes:
-      - ${DATA_PATH}:/usr/share/nginx/html:ro
   worker:
     container_name: photon_worker
     image: git.jrdn.dev/jordanwalster/photon-worker:latest
@@ -34,6 +27,5 @@ services:
       - db:/var/lib/mysql
     env_file:
       - .env
-
 volumes:
-  db:
+  db:

examples/compose-traefik.yml

@@ -0,0 +1,60 @@
+services:
+  # Photon services
+  photon:
+    container_name: photon_dashboard
+    image: git.jrdn.dev/jordanwalster/photon-dashboard:latest
+    volumes:
+      - ./db:/var/www/html/db # Only required if migrating from SQLite
+      - type: bind
+        source: ${DATA_PATH}
+        target: /var/www/html/data
+        bind:
+          propagation: rshared
+    env_file:
+      - .env
+    labels:
+      # Dashboard configuration
+      - "traefik.enable=true"
+      - "traefik.http.routers.photon.rule=Host(`${PHOTON_DOMAIN}`)"
+      - "traefik.http.routers.photon.service=photon"
+      - "traefik.http.services.photon.loadbalancer.server.port=80"
+      # Basic auth for dashboard (Replace this with your own credentials).
+      - "traefik.http.middlewares.photon-basic-auth.basicauth.users=${BASIC_AUTH_USER}:${BASIC_AUTH_PASSWORD}"
+      - "traefik.http.routers.photon.middlewares=photon-basic-auth"
+
+      # Custom domain for share links
+      - "traefik.http.routers.photon-share.rule=Host(`${PHOTON_SHARE_DOMAIN}`)"
+      - "traefik.http.routers.photon-share.service=photon-share"
+      - "traefik.http.middlewares.photon-share-path.addprefix.prefix=/share"
+      - "traefik.http.routers.photon-share.middlewares=photon-share-path"
+      - "traefik.http.services.photon-share.loadbalancer.server.port=80"
+  worker:
+    container_name: photon_worker
+    image: git.jrdn.dev/jordanwalster/photon-worker:latest
+    volumes:
+      - ${DATA_PATH}:/var/www/html/data
+    env_file:
+      - .env
+
+  # Database
+  db:
+    container_name: photon_db
+    image: mariadb
+    volumes:
+      - db:/var/lib/mysql
+    env_file:
+      - .env
+
+  # Reverse proxy
+  traefik:
+    container_name: traefik
+    image: traefik:v3
+    command:
+      - "--providers.docker=true"
+      - "--entrypoints.web.address=:80"
+    ports:
+      - "80:80"
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock
+volumes:
+  db: