ReadMe

The source for the mathworks.github.io landing page.

This readme covers basic maintenance tasks for the page owner.

Agent resources

• llms.txt: an index of this site for coding agents.
• Release quick starts: one Markdown quick start per release, newest first. Agents can read the index as Markdown.
• MATLAB and Simulink R2026b for Coding Agents: documentation, toolkits, MCP setup, R2026b workflows, validation, and support.

Local development

The site is static HTML/JS, so any local web server works. Two convenient options:

Docker Compose (recommended, matches the development container):

docker compose -f githubio.compose.yml up

Then open http://localhost:8080.

Python (no dependencies):

python -m http.server 8080

Python 3.12 or later serves .md files as text/markdown, so browsers display them. Python 3.11 and earlier serve them as application/octet-stream, so browsers download them instead.

The page fetches cache.json and stats.json over HTTP, so it does not work when opened from a file:// URL.

Local servers show their own error page for missing URLs. To review the site's 404 page, open http://localhost:8080/404.html.

Featured Projects

The Featured Projects section is rendered from a hand-curated list near the top of index.html. To add, remove, or reorder a featured project, edit the #featured block:

$('#featured').append(Mustache.render(featuredTemplate, {
  name: "MATLAB Agentic Toolkit",
  description: "Connect MATLAB to AI agents and agentic frameworks...",
  url: "https://github.com/matlab/matlab-agentic-toolkit",
  org: "MATLAB Development & AI Coding Projects"
}));

The org field should match one of the organization display names used below.

Release quick starts

Each quick start is a Markdown file in releases/, named for its release, such as releases/R2026b.md. The release index (releases/index.html and releases/index.md) and llms.txt give agents URLs that stay the same from release to release.

To add a release:

1. Add releases/<release>.md.
2. Add a row at the top of the table in both releases/index.html and releases/index.md, and move the "latest" label to it. In releases/index.html, copy the previous row, then update the release name, the Markdown link, the GitHub link, and both checked dates.
3. Update the Release quick starts section of llms.txt.
4. Update the latest-release link in the Featured Projects section of index.html.

Organizations

To add a new organization, make two modifications:

index.html

Find the block of templates added to the Organizations section. Add a new one in the same format, e.g.:

$('#orgs').append(Mustache.render(orgTemplate, {
  name: "MathWorks",
  description: "A diverse selection of MathWorks Open Source projects and resources",
  url: "https://github.com/mathworks"
}));

assets/javascripts/repo-helper.js

Add the organization to the orgs object. The current list is:

this.orgs = {
              'mathworks': 'MathWorks',
              'matlab': 'MATLAB Development & AI Coding Projects',
              'simulink': 'Simulink',
              'mathworks-ref-arch': 'Reference Architecture',
              'simscape': 'Simscape',
              'matlab-deep-learning' : 'Deep Learning',
              'MATLAB-Graphics-and-App-Building': 'Graphics and App Building',
              'MathWorks-Teaching-Resources': 'Teaching Resources',
              'mathworks-robotics' : 'Robotics',
              'MathWorks-SimBiology': 'SimBiology',
              'thingspeak': 'ThingSpeak'
            };

Regenerate the cache after adding an organization (see below).

Ignore

Individual repositories can be ignored by appending to the following array in assets/javascripts/repo-helper.js:

this.ignore_list = [ 'xilinx-linux', 'buildroot', 'xilinx-uboot', 'altera-linux', 'altera-uboot', '.github' ];

Repositories named mathworks.github.io are always excluded.

Cache

The page uses a cache for certain costly API requests, such as finding the most active contributors across organizations. The cache is also used if the API is not reachable, such as when the client has exhausted the rate limit for their IP.

To regenerate this cache periodically, perform the following:

• Generate an API token: GitHub Tokens
  • Classic tokens: public_repo, read:project, read:user, user:email
  • Fine-grained tokens also work; grant read-only access to public repositories and user metadata.
• Run fetchCache.js:

cd assets/javascripts
npm install
GITHUB_TOKEN=(PASTE YOUR TOKEN HERE) node ./fetchCache.js

e.g. for token ghp_1234567abcdefg:

cd assets/javascripts
npm install
GITHUB_TOKEN=ghp_1234567abcdefg node ./fetchCache.js

On PowerShell:

cd assets\javascripts
npm install
$env:GITHUB_TOKEN = "ghp_1234567abcdefg"
node .\fetchCache.js

• Commit the resulting cache.json and stats.json.