Project Architecture

How this project is structured

FML keeps formulas, app UI, and deployment concerns separated so curriculum updates do not require rewriting the full stack.

Formula Layer

Core math logic starts in fml-framework/formulas with reusable Python definitions. App-level JavaScript mirrors these formulas in each app's src/lib/math.js.

Tool Layer

AI-callable tools are defined in aiTools.js and executed through toolDispatcher.js. This keeps natural-language prompts mapped to deterministic solvers.

Curriculum Layer

Chapters are organized in src/chapters, where each module combines lesson content, input forms, result rendering, and optional visualization blocks.

Repository map

fml-framework/ reusable formulas and templates
mathf3-o/ Form 3 app
mathf4-o/ Form 4 app
portal/ multi-page root website
scripts/build-vercel.mjs unified deployment assembly

Extension model

To add a new syllabus level, clone the app structure, map chapter outcomes, implement formulas, and register matching tool schemas. The portal can then link the new route as another live page.

See curriculum adaptation