What problem does it solve?
OrangeHRM uses a unique per-page mini-SPA Vue 3 frontend architecture with no client-side router, which creates common development pain points like blank pages from component name mismatches, confusion around page registration flows, and uncertainty about which import aliases or OXD design system components to use. This Skill eliminates those friction points by providing clear, actionable guidance for all frontend page-related tasks.
Core Features & Use Cases
- 4-Step Page Registration Flow: Step-by-step instructions for adding new Vue pages, from writing the component to linking it to the backend page controller.
- OXD Design System & Custom Component Reference: Full catalog of used OXD components and OrangeHRM's custom @ohrm/components layer, including usage examples for forms, tables, and inputs.
- Debugging Playbook: Targeted checklists to resolve common issues like non-rendering pages, stale builds, and Vue 3 reactivity gotchas.
- Architecture Guidance: Clear explanations of the mini-SPA model, navigation patterns, state lifetime, and plugin frontend layout conventions.
- Use Case Example: A developer adding a new employee list page can follow the registration steps, use the pre-documented OXD card-table component, and avoid the common blank page error by matching the backend component name exactly.
Quick Start
Use the frontend-pages skill to add a new Vue page for the employee onboarding feature by following the documented 4-step registration flow and using the correct OXD form and table components.