skills/maxnorm/magento2-agent-skills/magento-hyva-specialist

magento-hyva-specialist

SKILL.md

Magento 2 Hyvä Specialist

Expert specialist in creating high-performance, modern Magento 2 storefronts using the Hyvä theme framework, leveraging Alpine.js, Tailwind CSS, and cutting-edge frontend technologies.

When to Use

  • Developing Hyvä-based storefronts
  • Working with Alpine.js components
  • Implementing Tailwind CSS styling
  • Optimizing frontend performance
  • Building modern, fast e-commerce experiences

Hyvä Development Stack

  • Alpine.js: Reactive JavaScript framework for dynamic interfaces
  • Tailwind CSS: Utility-first CSS framework for rapid styling
  • PostCSS: CSS processing and optimization
  • Webpack: Asset bundling and optimization
  • GraphQL Integration: Efficient data fetching from Magento's GraphQL API

Hyvä Development Process

1. Hyvä Setup & Configuration

  • Theme Installation: Set up Hyvä theme and development environment
  • Build Process: Configure and optimize build tools and workflows
  • Module Integration: Integrate Hyvä with existing Magento modules
  • Performance Baseline: Establish performance metrics and monitoring
  • Development Tools: Set up debugging and development utilities

2. Component Development

  • Alpine.js Components: Create reactive, lightweight components
  • Tailwind Styling: Apply utility-first CSS for responsive design
  • GraphQL Integration: Implement efficient data fetching patterns
  • State Management: Handle component state and data flow
  • Event Handling: Implement user interactions and form submissions

3. Layout & Template Development

  • Layout Optimization: Create efficient page layouts with minimal overhead
  • Template Conversion: Convert existing templates to Hyvä architecture
  • Component Library: Build reusable component library
  • Responsive Design: Implement mobile-first responsive layouts
  • Accessibility: Ensure WCAG compliance and screen reader support

4. Performance Tuning

  • Bundle Optimization: Minimize and optimize JavaScript bundles
  • CSS Purging: Remove unused CSS for smaller payloads
  • Critical CSS: Implement critical CSS for faster rendering
  • Lazy Loading: Implement progressive loading strategies
  • Caching Integration: Optimize for Magento's caching layers

Alpine.js Mastery

Component Architecture

  • Design scalable Alpine.js component patterns
  • Efficient data binding and state management
  • Create custom Alpine.js directives
  • Build Alpine.js plugins for reusable functionality
  • Optimize Alpine.js for minimal overhead

Data Management

  • Efficient data binding patterns
  • Component state management
  • Event handling and communication
  • Form handling and validation
  • AJAX integration

Tailwind CSS Advanced Usage

Custom Configuration

  • Customize Tailwind for brand-specific design systems
  • Create reusable component classes with @apply
  • Advanced responsive design patterns
  • Dark mode implementation
  • Animation and transitions

Styling Patterns

  • Utility-first approach
  • Component-based styling
  • Responsive utilities
  • Custom utilities and variants
  • Performance optimization

GraphQL Integration

  • Query Optimization: Write efficient GraphQL queries
  • Caching Strategies: Implement GraphQL caching patterns
  • Error Handling: Robust error handling for API calls
  • Real-time Updates: Implement real-time data synchronization
  • Batch Operations: Optimize multiple data operations

Performance Optimization

Core Web Vitals

  • LCP (Largest Contentful Paint): Optimize for fast loading
  • FID (First Input Delay): Minimize JavaScript execution time
  • CLS (Cumulative Layout Shift): Prevent layout shifts

Optimization Techniques

  • JavaScript Optimization: Minimize JavaScript payload
  • CSS Optimization: Efficient CSS delivery
  • Image Optimization: Modern image formats and responsive loading
  • Caching Strategies: Leverage browser and CDN caching
  • Resource Hints: Optimize resource loading

Best Practices

Development Workflow

  • Component-First: Design with reusable components in mind
  • Performance Budget: Maintain strict performance budgets
  • Mobile-First: Prioritize mobile experience and performance
  • Progressive Enhancement: Build with progressive enhancement principles
  • Accessibility First: Ensure accessibility from the start

Code Organization

  • Modular Structure: Organize code in logical, maintainable modules
  • Documentation: Maintain comprehensive component documentation
  • Version Control: Use Git effectively for collaborative development
  • Testing: Implement frontend testing strategies
  • Code Reviews: Establish peer review processes

Module Integration

  • Third-party Extensions: Integrate extensions with Hyvä architecture
  • Custom Modules: Adapt custom modules for Hyvä compatibility
  • Legacy Support: Bridge legacy code with modern Hyvä patterns
  • API Integration: Connect external services and APIs
  • Headless Architecture: Implement headless commerce patterns

References

Focus on creating Hyvä-based storefronts that deliver exceptional performance, user experience, and maintainability.

Weekly Installs
123
GitHub Stars
6
First Seen
Feb 17, 2026
Installed on
codex121
opencode120
gemini-cli118
cursor117
github-copilot117
kimi-cli117