Statamic Ai Writer Laravel Package

Getting Started

• Install the package in a Laravel/Statamic application and publish its config and translations with the package’s documented vendor:publish tags.
• Start by checking the Control Panel translations for en and de, then verify the assistant, editor integration, notifications, permissions, alt-text actions, and provider error messages in the Control Panel.
• First use case: localize the Control Panel for German editors while keeping content generation language/settings independent from the Control Panel locale.

Implementation Patterns

• Use per-user Control Panel locales for editorial teams; let the package resolve UI strings from the Control Panel locale rather than from content-generation settings.
• Publish translation overrides into the app’s lang/vendor/... structure and keep them in version control when customizing assistant, notification, permission, alt-text, or provider-error copy.
• For German-first teams, set the Control Panel locale to de and test editor integrations and alt-text actions with both English and German users.
• Keep content generation language configuration separate from Control Panel language configuration; do not assume changing one changes the other.
• When upgrading, re-check published translation overrides against the package’s new English/German source strings, especially for package-owned provider errors.

Gotchas and Tips

• Use v2.1.0+ if you rely on assistant script translations after Statamic’s view composer loads English fallback translations; older behavior could resolve English despite an explicit Control Panel locale.
• Clear Laravel/Statamic caches after publishing or editing translation overrides.
• Debug missing translations by confirming the Control Panel locale, the published vendor translation path, and whether the package’s own translation files are being overridden.
• Do not conflate Control Panel locale with content generation locale; the release explicitly separates them.
• Published translation overrides are an extension point but can drift across package upgrades, so review them when adding new assistant, editor, notification, permission, alt-text, or error strings.