| name | shopware-admin-js |
| description | 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. |
| license | MIT |
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.ts when adding new TypeScript tests.
- Split very large specs into a
.spec/ directory by behavior group.
Detailed Guidelines
- Read
coding-guidelines/administration/architecture.md when changing Admin architecture, component registration, services, state, or module patterns.
- Read
coding-guidelines/administration/testing.md when adding or restructuring Administration Jest tests.
- Read
coding-guidelines/administration/feature-flags-and-deprecations.md when touching Admin feature flags, deprecations, or BC behavior.