How gjohnhazel/zendesk_custom_theme works
Main Components
a. Frontend Architecture:
• Theme Core Components
• Templates Layer (Handlebars templates)
• Styling Layer (SCSS modules)
• JavaScript Core (Vanilla JS modules)
• React Components Layer
• Asset Management System
• Internationalization System
• Build System
b. Integration Points:
• Zendesk Guide Platform
• Zendesk Theming API
• Translation System
• Preview System
• Presentation Layer |
• Templates | | React Components| |
• (Handlebars) | | (Garden UI) | |
• Core Services Layer |
• I18n Service | | Asset Manager | |
• Theme Config | | Build Pipeline | |
• Integration Layer |
• Zendesk Guide | | Preview System | |
Component Relationships
• Data flow between components
• Dependencies
• Build process flow
• Asset loading paths
Key Elements to Highlight
a. Module System:
• How the import map works
• Bundle generation flow
• Asset resolution system
b. React Integration:
• Garden UI components
• Module bundling
• Theme integration points
c. Internationalization:
• Translation flow
• String extraction
• Locale management
d. Development Tooling:
• Build pipeline
• Preview system
• Accessibility testing
Additional Details
• File types (.hbs, .scss, .tsx, etc.)
• Build artifacts
• Configuration files
• Asset types
Notes for Implementation
• Keep component grouping logical and clear
• Clear separation between build-time and runtime components
• Version control and deployment paths