explaingit

mohanadtr/edutraceapp

11MDXAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

A curriculum viewer for Egyptian STEM high school students that displays lessons organized by official Learning Outcomes, with embeddable pages and direct URL navigation to specific topics.

Mindmap

mindmap
  root((edutraceapp))
    What it does
      Browse STEM lessons
      Navigate by outcome code
      Embed lessons in iframes
    Tech stack
      Next.js
      MDX
      Node.js
    Use cases
      Study by learning outcome
      Embed lessons in other sites
      Browse Grade 10 and 11 content
    Audience
      Students
      Teachers
      Platform builders
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Navigate directly to a specific Egyptian STEM lesson by typing its outcome code like /PH.1.01 in the browser.

USE CASE 2

Embed a specific lesson inside your own website or learning tool using an iframe.

USE CASE 3

Browse Grade 10 and 11 STEM curriculum content organized by subject and semester.

Tech stack

Next.jsMDXJavaScriptNode.js

Getting it running

Difficulty · easy Time to first run · 30min

Requires Node.js, setup is standard Next.js clone, install, and dev server start.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

EduTrace is an open-source curriculum viewer built for Egyptian high school students studying STEM subjects in Grades 10 and 11. It is the public layer of a free platform called EduTrace, and its main job is to display lesson content in an organized, browsable format tied to official Learning Outcomes for the Egyptian STEM program. The content in this repository is written in MDX, a format that mixes regular text with code and math notation. Each lesson is tied to a short code that reflects its subject and sequence, so a student or teacher can navigate directly to a specific outcome by typing something like /PH.1.01 in the browser address bar. Math formulas render properly on screen, and code examples appear with syntax highlighting. The project runs as a web application built on Next.js, a framework for building websites with JavaScript. To run it locally, you need Node.js installed, then clone the repository, install the dependencies, and start the development server with a few commands in a terminal. The folder structure separates routes and interface components from the actual curriculum files, which sit in a content directory organized by grade, semester, subject, and individual learning outcome. The embed system lets any lesson load inside an iframe, which means the content can be placed inside other websites or tools without the full site around it. This is useful for teachers or other platforms that want to link to specific lessons without redirecting students away from their own interface. The repository is released under the MIT license, so anyone can read the code, copy it, or contribute changes. The README asks for content improvements and bug fixes via pull requests. The README is short and the project appears focused on Egyptian national curriculum content rather than being a general-purpose learning management system.

Copy-paste prompts

Prompt 1
I want to add a new lesson to the EduTrace curriculum viewer. Show me the folder structure under the content directory and how to create an MDX file for a Physics Grade 10 learning outcome.
Prompt 2
Using the EduTrace Next.js app, show me how to set up the embed system so a specific lesson loads inside an iframe on an external website.
Prompt 3
Walk me through running the EduTrace app locally: cloning the repo, installing Node.js dependencies, and starting the development server.
Prompt 4
How do I add math formulas and code examples with syntax highlighting to an MDX lesson file in the EduTrace repo?
Open on GitHub → Explain another repo

← mohanadtr on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.