How testsigmahq/testsigma-tutorials works
Main Components
a. Frontend Layer:
• Gatsby Static Site Generator
• React Components (src/components)
• Templates (src/templates)
• Pages Structure (src/pages)
• Search Functionality
• Styling (SCSS/Tailwind)
b. Build & Deployment:
• GitHub Actions Workflows
• Production/Staging Environments
• Static Site Hosting
c. Content Management:
• Markdown Files
• JSON Configuration
• Navigation Structure
[Content Layer]
• ↓
[Build Layer]
• ↓
[Delivery Layer]
Specific Component Details
Content Layer:
• Markdown files organization (/tutorials subdirectories)
• JSON configurations (left-nav-title.json, redirects.json)
• Static assets (images)
Build Layer:
• Gatsby build process
• Custom plugins (gatsby-plugin-ts-freshchat)
• Component structure
• Search integration
Delivery Layer:
• CI/CD pipelines (.github/workflows)
• Production/Staging environments
• Static hosting
Important Relationships to Highlight
• How markdown files are processed through Gatsby's build system
• Component hierarchy (Layout → Pages → Components)
• Demonstrate search functionality flow
• Deployment pipeline stages
[Markdown Content] → [Gatsby Build Process] → [Static HTML/CSS/JS]
• ↑ ↑ ↓
[JSON Config Files] [React Components] [CDN/Hosting]
• ↑ ↑ ↑
[Static Assets] [Custom Plugins/Config] [CI/CD Pipeline]
Additional Notes
• Keep the content organization structure visible but not overwhelming
• Relationship between templates and generated pages
• How the navigation structure is built
• Search functionality as a distinct feature