How jakmann86/hexagon-maths works
hexagon-maths is a React teaching app for presenting curriculum lessons, interactive math visuals and practice, with client-side worksheet PDFs as a separate capability. The principal workflow is a learner entering the app, navigating the curriculum and viewing lesson sections; section content is rendered with math-aware components and shared UI state. The repository also contains question generators and a worksheet-generation pipeline. The README provides no product details, and several routing and content modules were not sampled, so some subsystem links are intentionally omitted or marked unverified.
Main entry points: StarterSectionBase.jsx Starter section base · MainLayout.jsx Main layout · WorksheetBuilder.js Worksheet builder · App.jsx App shell
Components 19
App and navigation
- React entry
maths-teaching-app/src/main.jsx - App shell
maths-teaching-app/src/App.jsx - Main layout
maths-teaching-app/src/components/layout/MainLayout.jsx - Section navigation
maths-teaching-app/src/components/navigation/SectionNav.jsx - UI state
maths-teaching-app/src/context/UIContext.jsx
Lessons and teaching
- Curriculum map
maths-teaching-app/src/data/curriculum.js - Lesson provider
maths-teaching-app/src/content/LessonContentProvider.jsx - Topic lesson sections
maths-teaching-app/src/content/topics - Starter section base
maths-teaching-app/src/components/sections/StarterSectionBase.jsx - Content renderer
maths-teaching-app/src/components/common/ContentRenderer.jsx - Question generators
maths-teaching-app/src/generators
Math visuals
- Math display
maths-teaching-app/src/components/common/MathDisplay.jsx - Math visualizations
maths-teaching-app/src/components/math/visualizations - Puzzle displays
maths-teaching-app/src/components/math/puzzles/SymbolPuzzleDisplay.jsx
Worksheet PDFs
- Worksheet builder
maths-teaching-app/src/worksheets/WorksheetBuilder.js - Worksheet questions
maths-teaching-app/src/worksheets/generators/pythagorasWorksheetGenerators.js - Diagram renderers
maths-teaching-app/src/worksheets/renderers - PDF generator
maths-teaching-app/src/worksheets/pdf/PDFGenerator.js
Other components
- Learner
Connections 20
- Learner → React entry: opens app
- React entry → App shell: renders
maths-teaching-app/src/main.jsx - App shell → UI state: provides state
maths-teaching-app/src/App.jsx - App shell → Main layout: renders
maths-teaching-app/src/App.jsx - Main layout → Section navigation: renders
maths-teaching-app/src/components/layout/MainLayout.jsx - Main layout → Curriculum map: reads
maths-teaching-app/src/components/layout/MainLayout.jsx - Main layout → Lesson provider: renders
maths-teaching-app/src/components/layout/MainLayout.jsx - Section navigation → Curriculum map: selects from
- Lesson provider → Topic lesson sections: loads sections
- Topic lesson sections → Starter section base: uses section base
- Starter section base → UI state: reads answers state
maths-teaching-app/src/components/sections/StarterSectionBase.jsx - Starter section base → Content renderer: renders content
maths-teaching-app/src/components/sections/StarterSectionBase.jsx - Starter section base → Math display: renders math
maths-teaching-app/src/components/sections/StarterSectionBase.jsx - Content renderer → Math display: renders math
maths-teaching-app/src/components/common/ContentRenderer.jsx - Starter section base → Puzzle displays: renders puzzles
maths-teaching-app/src/components/sections/StarterSectionBase.jsx - Starter section base → Math visualizations: renders visuals
maths-teaching-app/src/components/sections/StarterSectionBase.jsx - Topic lesson sections → Question generators: uses generators
- Worksheet builder → Worksheet questions: generates questions
maths-teaching-app/src/worksheets/WorksheetBuilder.js - Worksheet builder → Diagram renderers: renders diagrams
maths-teaching-app/src/worksheets/WorksheetBuilder.js - Worksheet builder → PDF generator: builds PDF
maths-teaching-app/src/worksheets/WorksheetBuilder.js