Shopware Admin JS
Developmentshopware-admin-jsShopware Admin JS is an Agent Skill for development published in the shopware/shopware repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Apply Shopware Administration JS/TS/Vue coding rules. Use when editing Admin UI code (.js/.ts/.vue) under src/Administration, including Jest specs and ACL-backed components.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/shopware/shopware/blob/HEAD/.agents/skills/shopware-admin-js/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/shopware-admin-js, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Shopware Admin JS
Keep general Administration structure, tech stack, docs links, and scripts in src/Administration/Resources/app/administration/AGENTS.md.
Code
- Use TypeScript for new code.
- Do not introduce public API breaks without prior discussion.
- Follow existing component, module, service, repository, and store patterns.
- For Admin UI that reads or persists DAL entities or associations, update matching ACL privilege mapping and migrations for existing roles when needed.
Tests
- Write Jest tests for new features and bug fixes.
- Keep tests next to the code under test with
.spec.tswhen adding new TypeScript tests. - Split very large specs into a
.spec/directory by behavior group.
Detailed Guidelines
- Read
coding-guidelines/administration/architecture.mdwhen changing Admin architecture, component registration, services, state, or module patterns. - Read
coding-guidelines/administration/testing.mdwhen adding or restructuring Administration Jest tests. - Read
coding-guidelines/administration/feature-flags-and-deprecations.mdwhen touching Admin feature flags, deprecations, or BC behavior.