How torbraw/quiz works
Core Architecture Components
a. Static Site Generation (Astro)
• This as a middle layer
• How it processes content and generates static pages
• To content sources
b. Content Management
• Questions content structure (fr/en)
• JSON data flow
• To static assets
Specific Implementation Details
• Rectangle: Pages and Routes
• Rounded Rectangle: Components
• Hexagon: Content (questions JSON)
Show:
• Content loading from JSON to pages
• Component composition
• Asset delivery to components
• Language switching paths
[Browser/Client]
• ↑
[Static Assets] ← [Astro Static Generation] ← [Content Sources]
• ↑ |
• [Component Layer] |
• ┴───────────────────────┘
Important Elements to Highlight:
Entry Points
• Main pages (/, /options, /history, /questions/[id])
• Language variants (/en/*)
Component Structure
• UI components
• Common components
• Question-specific components
Asset Management
• Media files (audio/video/images)
• Content files (questions JSON)
Build/Deploy Flow
• Static site generation
• Content processing
• Asset optimization
• Special indicators for internationalization
Keep the abstraction level appropriate by:
• Focusing on the static site architecture
• Highlighting the content management flow
• Showing clear component relationships
• Emphasizing the multilingual structure