fix: add Dashboard/Homepage translations and OPcache troubleshooting to README

README.md

@@ -428,6 +428,37 @@ Auto-detects: **Linux, Windows IIS, XAMPP, WAMP, Apache, Nginx**
 
 ---
 
+## Troubleshooting
+
+### 500 Error After `php artisan optimize`
+
+If you get a 500 error after running `php artisan optimize`, PHP OPcache is likely caching stale files. Fix:
+
+```bash
+# Disable OPcache in your FPM configuration:
+# Edit /etc/php/8.x/fpm/conf.d/99-opcache.ini
+opcache.enable=0
+
+# Then restart PHP-FPM:
+sudo systemctl restart php8.x-fpm
+```
+
+Alternatively, keep OPcache enabled but restart PHP-FPM after every `php artisan optimize`:
+
+```bash
+php artisan optimize
+sudo systemctl restart php8.x-fpm
+```
+
+### Filament Translations Not Working
+
+If Filament navigation labels or resource names aren't translating (e.g., Dashboard shows in English instead of Dutch):
+
+1. Add the missing key to `lang/vendor/filament/{locale}/resources.php` (navigations section) or `lang/{locale}.json`
+2. Clear the cache: `php artisan optimize:clear` (then restart PHP-FPM if OPcache is on)
+
+---
+
 ## Performance Optimizations
 
 | Optimization        | Description                      |

lang/nl.json

@@ -347,5 +347,6 @@
     "radio.wizard.test_not_run": "Nog niet getest.",
     "radio.wizard.test_connection_fail": "Kon de test niet uitvoeren: ",
     "radio.wizard.error": "Fout",
-    "radio.wizard.unknown_error": "Onbekende fout"
+    "radio.wizard.unknown_error": "Onbekende fout",
+    "Homepage": "Homepage"
 }