diff --git a/.editorconfig b/.editorconfig
new file mode 100644
index 0000000..88311ee
--- /dev/null
+++ b/.editorconfig
@@ -0,0 +1,24 @@
+# EditorConfig: https://editorconfig.org
+# These settings are honored by most editors and IDEs.
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[*.{json,jsonc}]
+indent_size = 2
+
+[Makefile]
+indent_style = tab
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
index dd84ea7..10a1b56 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -1,8 +1,8 @@
---
name: Bug report
about: Create a report to help us improve
-title: ''
-labels: ''
+title: '[Bug] '
+labels: 'bug'
assignees: ''
---
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000..5018628
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+ - name: ๐ฌ Questions & Discussions
+ url: https://github.com/marvelefe/machinelearning101/discussions
+ about: Ask questions, share ideas, or get help with using Machine Learning 101.
+ - name: ๐ Report a Security Vulnerability
+ url: https://github.com/marvelefe/machinelearning101/security/policy
+ about: Please report security issues privately โ do not open a public issue.
+ - name: ๐ Documentation
+ url: https://github.com/marvelefe/machinelearning101/blob/main/CONTRIBUTING.md
+ about: Read the contributing guide before opening a pull request.
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
index bbcbbe7..29e680a 100644
--- a/.github/ISSUE_TEMPLATE/feature_request.md
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -1,8 +1,8 @@
---
name: Feature request
about: Suggest an idea for this project
-title: ''
-labels: ''
+title: '[Feature] '
+labels: 'enhancement'
assignees: ''
---
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 0000000..51e9181
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,46 @@
+
+
+## Description
+
+
+
+## Related Issue
+
+
+Closes #
+
+## Type of Change
+
+- [ ] ๐ Bug fix (non-breaking change that fixes an issue)
+- [ ] โจ New feature (non-breaking change that adds functionality)
+- [ ] ๐ฅ Breaking change (fix or feature that changes existing behavior)
+- [ ] ๐ Documentation update
+- [ ] ๐จ Design / UX / accessibility improvement
+- [ ] โก Performance improvement
+- [ ] ๐งช Tests
+- [ ] ๐ง Chore / refactor / tooling
+
+## How Has This Been Tested?
+
+
+
+- [ ] `npm run test` passes
+- [ ] `npm run type-check` passes
+- [ ] `npm run build` succeeds
+
+## Screenshots / Recordings
+
+
+
+## Checklist
+
+- [ ] My change is focused and does one thing
+- [ ] I have added/updated tests for new or changed logic
+- [ ] I have updated relevant documentation
+- [ ] My commits follow [Conventional Commits](https://www.conventionalcommits.org/)
+- [ ] My branch is up to date with `main`
+- [ ] UI changes are responsive and keyboard accessible
+- [ ] I have read the [Contributing Guide](../CONTRIBUTING.md) and agree to the [Code of Conduct](../CODE_OF_CONDUCT.md)
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..2e83f29
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,78 @@
+name: CI
+
+on:
+ push:
+ branches: [main]
+ pull_request:
+ branches: [main]
+
+# Cancel superseded runs on the same ref to save CI minutes.
+concurrency:
+ group: ${{ github.workflow }}-${{ github.ref }}
+ cancel-in-progress: true
+
+permissions:
+ contents: read
+
+jobs:
+ quality:
+ name: Type-check & test
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v7
+
+ - name: Setup Node
+ uses: actions/setup-node@v7
+ with:
+ node-version-file: .nvmrc
+ cache: npm
+
+ - name: Install dependencies
+ run: npm ci
+
+ - name: Type-check
+ run: npm run type-check
+
+ - name: Unit tests
+ run: npm run test
+
+ build:
+ name: Build
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v7
+
+ - name: Setup Node
+ uses: actions/setup-node@v7
+ with:
+ node-version-file: .nvmrc
+ cache: npm
+
+ - name: Install dependencies
+ run: npm ci
+
+ - name: Build
+ run: npm run build
+
+ # NOTE: The Cloudflare Worker in worker/ is a separate sub-project with its own
+ # dependencies, tsconfig and tests. It is intentionally NOT part of this
+ # workflow yet because its test suite currently has pre-existing failures and
+ # type errors (see the tracking issue). Once those are resolved, add a job here:
+ #
+ # worker:
+ # runs-on: ubuntu-latest
+ # defaults:
+ # run:
+ # working-directory: worker
+ # steps:
+ # - uses: actions/checkout@v7
+ # - uses: actions/setup-node@v7
+ # with:
+ # node-version-file: .nvmrc
+ # cache: npm
+ # cache-dependency-path: worker/package-lock.json
+ # - run: npm ci
+ # - run: npm run type-check
+ # - run: npm run test
diff --git a/.nvmrc b/.nvmrc
new file mode 100644
index 0000000..2bd5a0a
--- /dev/null
+++ b/.nvmrc
@@ -0,0 +1 @@
+22
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
new file mode 100644
index 0000000..55dab09
--- /dev/null
+++ b/CODE_OF_CONDUCT.md
@@ -0,0 +1,129 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes,
+ and learning from the experience
+- Focusing on what is best not just for us as individuals, but for the overall
+ community
+
+Examples of unacceptable behavior include:
+
+- The use of sexualized language or imagery, and sexual attention or advances of
+ any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email address,
+ without their explicit permission
+- Other conduct which could reasonably be considered inappropriate in a
+ professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+**marvelcamoarmy@gmail.com**.
+
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+https://www.contributor-covenant.org/version/2/1/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..497a443
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,216 @@
+# Contributing to Machine Learning 101
+
+First off, thank you for considering a contribution! ๐ This project exists to
+make machine learning approachable for everyone, and contributions of all kinds โ
+code, content, docs, design, and bug reports โ are welcome and appreciated.
+
+By participating, you agree to abide by our
+[Code of Conduct](CODE_OF_CONDUCT.md).
+
+- ๐ Live site: **https://machinelearning101.com**
+- ๐ [Report a bug](https://github.com/marvelefe/machinelearning101/issues/new?template=bug_report.md)
+- ๐ก [Request a feature](https://github.com/marvelefe/machinelearning101/issues/new?template=feature_request.md)
+- ๐ [Good first issues](https://github.com/marvelefe/machinelearning101/labels/good%20first%20issue)
+- ๐ค [Help wanted](https://github.com/marvelefe/machinelearning101/labels/help%20wanted)
+
+---
+
+## Ways to Contribute
+
+You don't need to be an ML expert or a seasoned developer. Some of the most
+valuable contributions are:
+
+| Type | Examples |
+| ---- | -------- |
+| ๐ **Bug fixes** | Broken visualizations, wrong math, mobile layout issues |
+| โจ **New modules** | Add an algorithm, dataset, or interactive demo |
+| ๐ **Documentation** | Fix typos, clarify explanations, improve the guides in `docs/` |
+| ๐จ **Design & UX** | Accessibility, responsive layout, clearer controls |
+| โก **Performance** | Bundle size, rendering, Web Worker offloading |
+| ๐งช **Tests** | Increase coverage in `tests/` |
+| ๐ **Localization** | Help translate the learning content |
+
+Not sure where to start? Browse issues labeled
+[`good first issue`](https://github.com/marvelefe/machinelearning101/labels/good%20first%20issue)
+or open a [discussion/question](https://github.com/marvelefe/machinelearning101/issues/new)
+and we'll help you find something.
+
+---
+
+## Getting Started
+
+### Prerequisites
+
+- **Node.js** 22 or higher (see [`.nvmrc`](.nvmrc)) โ we recommend
+ [nvm](https://github.com/nvm-sh/nvm): `nvm use`
+- **npm** 10 or higher
+- **Git**
+- Basic familiarity with Vue 3, TypeScript, and machine learning concepts is
+ helpful but not required for docs/design work.
+
+### Set Up Your Environment
+
+1. **Fork** the repository on GitHub (use the **Fork** button in the top-right).
+
+2. **Clone your fork** and enter the directory:
+
+ ```bash
+ git clone https://github.com/YOUR_USERNAME/machinelearning101.git
+ cd machinelearning101
+ ```
+
+3. **Add the upstream remote** so you can stay in sync:
+
+ ```bash
+ git remote add upstream https://github.com/marvelefe/machinelearning101.git
+ ```
+
+4. **Install dependencies**:
+
+ ```bash
+ npm install
+ ```
+
+5. **Start the dev server**:
+
+ ```bash
+ npm run dev
+ ```
+
+6. **Verify** by opening `http://localhost:3000`.
+
+---
+
+## Development Workflow
+
+### 1. Create a Branch
+
+Always branch off an up-to-date `main`:
+
+```bash
+git checkout main
+git pull upstream main
+git checkout -b feat/your-feature-name
+# or
+git checkout -b fix/short-bug-description
+# or
+git checkout -b docs/what-you-are-documenting
+```
+
+Branch prefix convention: `feat/`, `fix/`, `docs/`, `chore/`, `refactor/`.
+
+### 2. Make Your Changes
+
+Please follow the project's coding standards (see [`AGENTS.md`](AGENTS.md)):
+
+- **TypeScript** everywhere; no implicit `any`, and type your public APIs.
+- **Vue 3 Composition API** with `
+
+
diff --git a/composables/useLazyAlgorithm.ts b/composables/useLazyAlgorithm.ts
index 846b696..e27c112 100644
--- a/composables/useLazyAlgorithm.ts
+++ b/composables/useLazyAlgorithm.ts
@@ -7,10 +7,7 @@
* Requirements: 14.4, 14.8
*/
-import type { Algorithm } from '~/types/algorithm';
-
-type AlgorithmConstructor = new (...args: any[]) => T;
-
+type AlgorithmConstructor = new (...args: any[]) => T;
/**
* Lazy load an algorithm by domain and name
*/
@@ -86,7 +83,7 @@ export function useLazyAlgorithm() {
switch (name) {
case 'GradientDescentOptimizer': {
const module = await import('~/algorithms/optimization/GradientDescentOptimizer');
- return module.GradientDescentOptimizer;
+ return (module as unknown as Record).GradientDescentOptimizer!;
}
case 'GradientDescentVisualization': {
const module = await import('~/algorithms/optimization/GradientDescentVisualization');
@@ -94,7 +91,7 @@ export function useLazyAlgorithm() {
}
case 'LossLandscape': {
const module = await import('~/algorithms/optimization/LossLandscape');
- return module.LossLandscape;
+ return (module as unknown as Record).LossLandscape!;
}
default:
throw new Error(`Unknown optimization algorithm: ${name}`);
diff --git a/composables/useModuleContent.ts b/composables/useModuleContent.ts
index fde900f..eab544f 100644
--- a/composables/useModuleContent.ts
+++ b/composables/useModuleContent.ts
@@ -7,7 +7,7 @@
export const useModuleContent = async (domain: string, moduleId: string) => {
const { data: content } = await useAsyncData(
`${domain}-${moduleId}-content`,
- () => queryContent(`modules/${domain}/${moduleId}/content`).findOne()
+ () => queryCollection('content').path(`/modules/${domain}/${moduleId}/content`).first()
);
return {
diff --git a/composables/useModules.ts b/composables/useModules.ts
index b96c5cb..046d933 100644
--- a/composables/useModules.ts
+++ b/composables/useModules.ts
@@ -215,7 +215,7 @@ export function useModules() {
const results = await Promise.all(configPromises);
// Filter out null results
- return results.filter((module): module is ModuleMetadata => module !== null);
+ return results.filter((module): module is NonNullable => module !== null);
};
/**
diff --git a/composables/useSEO.ts b/composables/useSEO.ts
index 41069a4..986fefc 100644
--- a/composables/useSEO.ts
+++ b/composables/useSEO.ts
@@ -8,7 +8,7 @@
*/
import { useHead, useSeoMeta } from '#app'
-import type { UseSeoMetaInput } from '@unhead/schema'
+import type { UseSeoMetaInput } from '@unhead/vue'
export interface SEOConfig {
title: string
@@ -91,7 +91,9 @@ export function useSEO(config: SEOConfig) {
// Robots
...(config.noindex && { robots: 'noindex, nofollow' }),
- } as UseSeoMetaInput)
+ // `config.author` is a single string while unhead types `articleAuthor` as
+ // a list; keep the runtime value unchanged.
+ } as unknown as UseSeoMetaInput)
// Set canonical URL and other head elements
useHead({
diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
index 4bf4284..4c389a4 100644
--- a/docs/CONTRIBUTING.md
+++ b/docs/CONTRIBUTING.md
@@ -1,129 +1,10 @@
-# Contributing to ML Learning Platform
+# Contributing
-Thank you for your interest in contributing! This document provides guidelines and instructions for contributing to the project.
+The canonical contribution guide for this project lives at the repository root:
-## Getting Started
+## ๐ [CONTRIBUTING.md](../CONTRIBUTING.md)
-### Prerequisites
+It covers setup, development workflow, coding standards, testing, commit
+conventions, and how to add a new learning module.
-- Node.js 18 or higher
-- npm or yarn
-- Git
-- Basic knowledge of Vue 3, TypeScript, and machine learning concepts
-
-### Setting Up Your Development Environment
-
-1. **Fork the repository** on GitHub
-
-2. **Clone your fork**:
-```bash
-git clone https://github.com/YOUR_USERNAME/ml-learning-platform.git
-cd ml-learning-platform
-```
-
-3. **Add upstream remote**:
-```bash
-git remote add upstream https://github.com/ORIGINAL_OWNER/ml-learning-platform.git
-```
-
-4. **Install dependencies**:
-```bash
-npm install
-```
-
-5. **Start development server**:
-```bash
-npm run dev
-```
-
-6. **Verify the setup** by visiting `http://localhost:3000`
-
-## How to Contribute
-
-### Types of Contributions
-
-We welcome various types of contributions including:
-- ๐ Bug Fixes
-- โจ New Features
-- ๐ Documentation
-- ๐จ Design Improvements
-- โก Performance Optimizations
-
-
-## Development Workflow
-
-### 1. Create a Branch
-
-Always create a new branch for your work:
-
-```bash
-# Update your main branch
-git checkout main
-git pull upstream main
-
-# Create a feature branch
-git checkout -b feature/your-feature-name
-# or
-git checkout -b fix/bug-description
-```
-
-### 2. Make Your Changes
-
-- Write clean, readable code
-- Follow the project's coding standards
-- Add comments for complex logic
-- Include JSDoc comments for public APIs
-
-### 3. Test Your Changes
-
-```bash
-# Run unit tests
-npm run test
-
-# Build the project
-npm run build
-
-# Preview the build
-npm run preview
-```
-
-### 4. Commit Your Changes
-
-Follow [Conventional Commits](https://www.conventionalcommits.org/):
-
-```bash
-git add .
-git commit -m "feat: add k-nearest neighbors algorithm"
-```
-
-### 5. Push to Your Fork
-
-```bash
-git push origin feature/your-feature-name
-```
-
-### 6. Create a Pull Request
-
-1. Go to your fork on GitHub
-2. Click "New Pull Request"
-3. Select your branch
-4. Fill out the PR template
-5. Submit the PR
-
-## Submitting Changes
-
-### Pull Request Checklist
-
-Before submitting a PR, ensure:
-
-- [ ] Code follows project style guidelines
-- [ ] All tests pass (`npm run test`)
-- [ ] Build succeeds (`npm run build`)
-- [ ] No console errors or warnings
-- [ ] Documentation is updated
-- [ ] Commit messages follow conventions
-- [ ] Branch is up to date with main
-- [ ] PR description is clear and complete
-
-
-Thank you for contributing to ML Learning Platform! ๐
+For everything else, see the [documentation index](../README.md#-documentation).
diff --git a/docs/DIRECTORY_LISTINGS.md b/docs/DIRECTORY_LISTINGS.md
new file mode 100644
index 0000000..ca470c3
--- /dev/null
+++ b/docs/DIRECTORY_LISTINGS.md
@@ -0,0 +1,366 @@
+# Directory & Awesome-List Submission Opportunities
+
+Research date: **2026-10-17**
+
+Project: **Machine Learning 101** โ ยท repo:
+Type: free, open-source (MIT), browser-based **interactive** ML learning platform for beginners (Nuxt 4 / Vue 3 / TypeScript).
+
+This document lists curated GitHub directories ("awesome" lists, learning-resource indexes, ecosystem showcases)
+where the project can legitimately be added via a pull request. Every repo below was verified live with the GitHub
+API (star count, last push, merge activity) and its `README.md` / `CONTRIBUTING.md` were read to confirm the exact
+insertion point and the required entry format.
+
+> **Key strategic note.** Most *library/tool* awesome-lists gate on GitHub stars for the **project being submitted**
+> (e.g. 50+, 1,000+). Machine Learning 101 is a **learning resource / website**, not a library, so the realistic wins
+> are lists that index *educational resources and websites* โ those have no star threshold. Those are ranked first.
+>
+> **Pre-req:** the repo reports no LICENSE to GitHub's licensee detector even though a valid `LICENSE` (MIT) file
+> exists at the root. Before submitting to lists that link sources, double-check that GitHub shows the MIT badge
+> (add the SPDX line only if needed). No candidate below requires the *submitted site* to carry an awesome badge.
+
+---
+
+## Summary table
+
+| # | Repo | Stars | Active? | What to add / where | Confidence |
+|---|------|-------|---------|---------------------|------------|
+| 1 | [academic/awesome-datascience](#1-academicawesome-datascience) | ~30.2k | **Yes** โ merges daily | `README.md` โ `## Training Resources` โ `### Tutorials` (append) | **High** |
+| 2 | [nuxt/awesome](#2-nuxtawesome) | ~5.5k | **Yes** โ last merge 2026-10-10 | `README.md` โ `### Projects Using Nuxt` (append) | **High** |
+| 3 | [hamid-moghadam/awesome-interactive-learning](#3-hamid-moghadamawesome-interactive-learning) | ~10 | **Yes** โ merges 2026-10-12/16 | `README.md` โ new `## Machine Learning & AI` (or `## Other Great Resources`) | **High** (low reach) |
+| 4 | [vuejs/awesome-vue](#4-vuejsawesome-vue) | ~73.5k | **Yes** โ merges 2026-10-01 | `README.md` โ `## Projects Using Vue.js` โ `### Apps/Websites` (append) | **Medium-High** |
+| 5 | [gs00s/awesome-vue-3](#5-gs00sawesome-vue-3) | ~1.6k | Yes โ last merge 2026-08-01 | `README.md` โ `## Courses` (append) | **Medium-High** |
+| 6 | [TirendazAcademy/Awesome-Data-Science-Resources](#6-tirendazacademyawesome-data-science-resources) | ~121 | Yes โ pushed 2026-08-17 | `README.md` โ `# ๐ MACHINE LEARNING` โ `### Courses` | **Medium-High** |
+| 7 | [josephmisiti/awesome-machine-learning](#7-josephmisitiawesome-machine-learning) | ~74.6k | Yes โ but PRs restricted | `courses.md` โ `## Machine-Learning / Data Mining` | Medium |
+| 8 | [ChristosChristofidis/awesome-deep-learning](#8-christoschristofidisawesome-deep-learning) | ~29k | Semi โ last merge 2025-05 | `README.md` โ `### Websites` (append) | Medium |
+| 9 | [howie6879/mlhub123](#9-howie6879mlhub123) | ~1.1k | **Yes** โ pushed 2026-10-16 | `README.md` โ `## ่ตๆบ` โ `### ่ตๆบๆถ้` | Medium (ไธญๆ) |
+| 10 | [guillaume-chevalier/Awesome-Deep-Learning-Resources](#10-guillaume-chevalierawesome-deep-learning-resources) | ~1.8k | Low โ last push 2024-01 | `README.md` โ `## Online Classes` (append) | Medium-Low |
+| 11 | [ujjwalkarn/Machine-Learning-Tutorials](#11-ujjwalkarnmachine-learning-tutorials) | ~18.3k | Low โ last push 2024-06 | `README.md` โ `## Introduction` (append) | Medium-Low |
+| 12 | [owainlewis/awesome-artificial-intelligence](#12-owainlewisawesome-artificial-intelligence) | ~16.7k | Yes โ last merge 2026-08 | `README.md` โ `## Learn` โ `### Courses` | Medium-Low (selective) |
+| 13 | [allmachinelearning/MachineLearning](#13-allmachinelearningmachinelearning) | ~3.9k | Low โ last push 2024-04 | `README.md` โ `## ่ฏพ็จไธ่ฎฒๅบง` โ `### ๆบๅจๅญฆไน ` | Low (ไธญๆ, stale) |
+
+**Clearly NO (do not submit):** see [Not recommended / rejected](#not-recommended--rejected).
+
+---
+
+## 1. academic/awesome-datascience
+
+- **URL:** ยท **Stars:** ~30,198 ยท **Default branch:** `live`
+- **Activity:** **Very active** โ merged PRs #724/#725/#727 all on 2026-10-16. Actively maintained.
+- **What it indexes:** A broad "awesome Data Science" list of tools, courses, tutorials, books, datasets, communities.
+ Explicitly beginner-oriented ("How do you learn data science? By doing data science").
+- **Fit:** **Excellent.** The `### Tutorials` subsection already contains interactive/visual ML learning resources
+ (e.g. *StepByStepML โ interactive calculator that visualizes the step-by-step math behind ML algorithms*).
+ A free browser-based interactive platform fits the section's intent squarely.
+- **Exact place:** `README.md` โ `## Training Resources` โ `### Tutorials`. Append at the **end** of the section
+ (after `Train LLM From Scratch`). The section is not alphabetized; append-only is consistent with recent edits.
+- **Contribution requirements (`CONTRIBUTING.md`):** consistent bullet format `- [Name](URL) - Short description.`;
+ descriptions one sentence, title case, **no marketing language/superlatives**; prefer `https://`, no URL shorteners;
+ add near similar items; complete the PR template (tip model, license type, **your relationship to the project**);
+ link checks must pass. Code of Conduct applies.
+- **Proposed entry:**
+ ```markdown
+ - [Machine Learning 101](https://machinelearning101.com) - Free browser-based platform that teaches core machine learning algorithms through hands-on, interactive visualizations with no setup.
+ ```
+- **Confidence:** **High.**
+
+---
+
+## 2. nuxt/awesome
+
+- **URL:** (canonical; `nuxt-community/awesome-nuxt` redirects here) ยท **Stars:** ~5,537
+- **Activity:** Active โ `chore(showcase): remove faker.js` merged 2026-10-10; showcase entries are hand-curated.
+- **What it indexes:** Everything Nuxt โ official resources, modules, examples, articles, books, open-source projects,
+ and a large curated **"Projects Using Nuxt"** website showcase.
+- **Fit:** **Excellent.** ML101 is built with Nuxt 4. The showcase section lists production/education websites
+ (Khan-style platforms, universities, products) with a one-line description.
+- **Exact place:** `README.md` โ `### Projects Using Nuxt`. Append to the **bottom** of the list (the section is a plain
+ bullet list; new sites are added at the end).
+- **Contribution requirements (`contributing.md`):** submission **must be Nuxt related**; search for duplicates first;
+ **one suggestion per PR**; format exactly `[Title](link) - Description.`; additions go to the **bottom of the
+ relevant category**; descriptions start with a capital and end with a period, no leading "A"/"An"; no trailing
+ whitespace; PR title should state the package/site and why it belongs. New categories in a separate PR.
+- **Proposed entry:**
+ ```markdown
+ - [Machine Learning 101](https://machinelearning101.com) - Free, interactive, browser-based machine learning learning platform for beginners.
+ ```
+- **Confidence:** **High.**
+
+---
+
+## 3. hamid-moghadam/awesome-interactive-learning
+
+- **URL:** ยท **Stars:** ~10
+- **Activity:** **Very active for its age** โ new repo, PRs #1 (2026-10-12) and #2 (2026-10-16) already merged.
+ CC0-licensed, clearly welcoming contributions.
+- **What it indexes:** *Only* interactive learning platforms, visualizations, labs and hands-on courses
+ (Learn Git Branching, Seeing Theory, Frontend Mentor, AlgoViz, โฆ). This is the most on-topic list found.
+- **Fit:** **Perfect conceptually** โ but reach is tiny (single-digit stars). Low risk, low reward.
+- **Exact place:** `README.md`. Either append to `## Other Great Resources`, **or** (better) open a small companion PR
+ adding a new `## Machine Learning & AI` section and its entry in `## Contents`.
+- **Contribution requirements (`CONTRIBUTING.md`):** resource **must be interactive** (not static article/video);
+ PR body uses format `- [Name](https://example.com/) โ Short description (1 sentence)` (note the en dash `โ`).
+- **Proposed entry:**
+ ```markdown
+ - [Machine Learning 101](https://machinelearning101.com) โ Free browser-based platform for learning ML algorithms by adjusting parameters and watching training run live.
+ ```
+- **Confidence:** **High** (that it is accepted); reach is **low**.
+
+---
+
+## 4. vuejs/awesome-vue
+
+- **URL:** ยท **Stars:** ~73,516
+- **Activity:** **Very active** โ multiple merges on 2026-10-01 (#4559, #4556, #4554).
+- **What it indexes:** The flagship Vue.js list: projects, components, ecosystem, and a "Projects Using Vue.js" showcase
+ split into `### Open Source`, `### Commercial Products`, `### Apps/Websites`, `### Interactive Experiences`.
+- **Fit:** **Good.** Submit to the **website** showcase (not "Open Source", which requires the linked repo to be the
+ entry and is stricter). Nuxt/Vue is used intensively and is detectable with vue-devtools, which satisfies the rule.
+- **Exact place:** `README.md` โ `## Projects Using Vue.js` โ `### Apps/Websites`. **Append to the end** (order is
+ first-come-first-served).
+- **Contribution requirements (`.github/contributing.md` + `pull_request_template.md`):** put items in the right
+ category; **always add to the end of the list**; site must load without errors/SSL issues and be reasonably fast;
+ must use Vue intensively (detectable via vue-devtools, else attach a screenshot in the PR); must be **original and
+ not too simple** (blogs/simple landing pages rejected); not a commercial product. Fill out the PR template checkboxes.
+- **Proposed entry:**
+ ```markdown
+ - [Machine Learning 101](https://machinelearning101.com) - Interactive, browser-based machine learning learning platform for beginners built with Vue and Nuxt.
+ ```
+- **Confidence:** **Medium-High.**
+
+---
+
+## 5. gs00s/awesome-vue-3
+
+- **URL:** ยท **Stars:** ~1,646
+- **Activity:** Yes โ merges on 2026-08-01 (#150, #149, #147).
+- **What it indexes:** Curated list of *Vue 3* resources, articles, packages, examples, tools, videos, books, courses.
+- **Fit:** Good โ a real Vue 3 + Nuxt project can be listed as a course/resource. The `## Courses` section holds
+ learning platforms (Vue School, Vue Mastery, Frontend Masters).
+- **Exact place:** `README.md` โ `## Courses`. Append at the bottom. (Alternative: `## Examples` only if you point to
+ the source repo; Courses is the better semantic fit for a learning platform.)
+- **Contribution requirements (`CONTRIBUTING.md`):** state the **intent/problem** in the PR; quality bar (no spelling
+ mistakes, reads well); must move the repo toward its vision; respect the Contributor Covenant. No strict formatting
+ mandate โ mirror the existing bullet style.
+- **Proposed entry:**
+ ```markdown
+ - [Machine Learning 101](https://machinelearning101.com) - Interactive Vue 3 and Nuxt learning platform that teaches machine learning through in-browser visualizations.
+ ```
+- **Confidence:** **Medium-High.**
+
+---
+
+## 6. TirendazAcademy/Awesome-Data-Science-Resources
+
+- **URL:** ยท **Stars:** ~121
+- **Activity:** Pushed 2026-08-17. Low-volume but current; no CONTRIBUTING.md (follow existing style).
+- **What it indexes:** A tidy, sectioned data-science resource list: Data Science, **Machine Learning**, ML Engineering,
+ Deep Learning, Generative AI, NLP, Data Engineering, SQL โ each with `Free Books`, `Courses`, `Tools`, `Repos`, `Projects`.
+- **Fit:** **Good.** The `# ๐ MACHINE LEARNING` โ `### Courses` block already lists third-party learning resources
+ (Coursera, TutorialSearch, โฆ). An interactive free platform fits.
+- **Exact place:** `README.md` โ `# ๐ MACHINE LEARNING` โ `### Courses`. Append at the bottom of that list.
+- **Contribution requirements:** No `CONTRIBUTING.md`; match the surrounding bullets (`- [Name](url) - description`).
+ Keep it factual and free.
+- **Proposed entry:**
+ ```markdown
+ - [Machine Learning 101](https://machinelearning101.com) - Free interactive browser-based platform to learn machine learning algorithms by experimenting with them.
+ ```
+- **Confidence:** **Medium-High.**
+
+---
+
+## 7. josephmisiti/awesome-machine-learning
+
+- **URL:** ยท **Stars:** ~74,597 ยท **Default branch:** `master`
+- **Activity:** Repo pushed 2026-10-13, but the README carries an explicit notice: *"As of April 2026, too many PRs are
+ being generated by LLMsโฆ If you want to contributeโฆ email me โฆ with a link to your PR and I'll merge it."*
+- **What it indexes:** The main list is **frameworks, libraries and software by language**. Learning material lives in
+ separate files: `books.md`, `courses.md`, `blogs.md`, `events.md`, `meetups.md`.
+- **Fit:** The interactive platform belongs **only** in `courses.md` ("free or paid online courses on machine learningโฆ").
+ `courses.md` already lists visual/interactive items (MLU-Explain, fast.ai) and even platform-style entries.
+- **Exact place:** `courses.md` โ `## Machine-Learning / Data Mining`, near the top (recent "System Designer"
+ platform entries are at the top).
+- **Contribution requirements:** No CONTRIBUTING.md, but the README notice **requires emailing the maintainer** to prove
+ you are human, with a link to the PR. Entries use `* [Name](url) - description - free`. Expect friction.
+- **Proposed entry:**
+ ```markdown
+ * [Machine Learning 101](https://machinelearning101.com) - Interactive, browser-based platform for learning core ML algorithms through hands-on visualizations - free
+ ```
+- **Confidence:** **Medium** (great reach; extra manual email gate + it is primarily a software list).
+
+---
+
+## 8. ChristosChristofidis/awesome-deep-learning
+
+- **URL:** ยท **Stars:** ~29,057
+- **Activity:** Semi-active โ last merge 2025-05-26 (#252). Occasional merges; the list is dated but still widely used.
+- **What it indexes:** Deep-learning books, courses, videos, papers, tutorials, **websites**, datasets, tools,
+ communities.
+- **Fit:** Good โ the `### Websites` section is literally external sites (deeplearning.net, Stanford pagesโฆ); ML101 is a
+ website. `### Tutorials` is a reasonable alternative.
+- **Exact place:** `README.md` โ `### Websites`. Entries are a **numbered list** (`1. [name](url)`); append as the next
+ number.
+- **Contribution requirements:** `### Contributing` says simply to send a pull request (the link points to a fork's PR
+ page). No linting, no format spec beyond the numbered list. CC0.
+- **Proposed entry:**
+ ```markdown
+ 11. [Machine Learning 101](https://machinelearning101.com)
+ ```
+- **Confidence:** **Medium** (slow maintainer; dated README aesthetic).
+
+---
+
+## 9. howie6879/mlhub123
+
+- **URL:** ยท **Stars:** ~1,147
+- **Activity:** **Very active** โ pushed 2026-10-16.
+- **What it indexes:** A Chinese-language roundup of ML/DL **websites & resources** (news, tools, communities, blogs,
+ courses, open-source books, projects).
+- **Fit:** Good if you can supply a Chinese description; it indexes learning websites directly.
+- **Exact place:** `README.md` โ `## ่ตๆบ` โ `### ่ตๆบๆถ้` (resource collection) or `### ่ฏพ็จๅญฆไน ` (courses).
+- **Contribution requirements:** No `CONTRIBUTING.md`; entries are Chinese bullet lines; the site itself is bilingual,
+ so a Chinese one-liner is expected. `https://machinelearning101.com` is fine as the URL.
+- **Proposed entry:**
+ ```markdown
+ - [Machine Learning 101](https://machinelearning101.com) - ๅ
่ดน็ๆต่งๅจ็ซฏไบคไบๅผๆบๅจๅญฆไน ๅญฆไน ๅนณๅฐ๏ผ้่ฟๅฏ่งๅๅฎ้ชๅธฎๅฉๅๅญฆ่
็่งฃ็ฎๆณใ
+ ```
+- **Confidence:** **Medium** (language requirement; active maintainer).
+
+---
+
+## 10. guillaume-chevalier/Awesome-Deep-Learning-Resources
+
+- **URL:** ยท **Stars:** ~1,821
+- **Activity:** Low โ last push 2024-01-18. Personal but fairly popular list.
+- **What it indexes:** Trends, **Online Classes**, books, posts, practical resources, math theory, papers, videos, and a
+ `Misc. Hubs & Links` section.
+- **Fit:** Medium โ the list is opinionated/personal; `## Online Classes` (which includes free courses and YouTube
+ series) is the best home. `## Misc. Hubs & Links` is a fallback.
+- **Exact place:** `README.md` โ `## Online Classes`, append; or `## Misc. Hubs & Links`.
+- **Contribution requirements:** No CONTRIBUTING.md; match `- [Name](url) - description.` bullets.
+- **Proposed entry:**
+ ```markdown
+ - [Machine Learning 101](https://machinelearning101.com) - Free, browser-based interactive platform for building intuition about ML algorithms with zero setup.
+ ```
+- **Confidence:** **Medium-Low** (stale maintenance).
+
+---
+
+## 11. ujjwalkarn/Machine-Learning-Tutorials
+
+- **URL:** ยท **Stars:** ~18,280
+- **Activity:** Low โ last push 2024-06-12. Large and well-known, but quiet.
+- **What it indexes:** Beginner ML/DL tutorials, courses and articles, grouped by topic (`## Introduction`,
+ `## Other Tutorials`, per-algorithm sections).
+- **Fit:** Medium โ `## Introduction` already lists beginner breakthroughs and "curated list" links; a free interactive
+ beginner platform fits there or in `## Other Tutorials`.
+- **Exact place:** `README.md` โ `## Introduction`, append; or `## Other Tutorials` (end of file).
+- **Contribution requirements:** No CONTRIBUTING.md. Entries are plain `- [Name](url)` bullets. Large list, informal
+ review; CC0.
+- **Proposed entry:**
+ ```markdown
+ - [Machine Learning 101](https://machinelearning101.com)
+ ```
+- **Confidence:** **Medium-Low** (maintainer inactivity; may not be reviewed).
+
+---
+
+## 12. owainlewis/awesome-artificial-intelligence
+
+- **URL:** ยท **Stars:** ~16,680
+- **Activity:** Yes โ merges 2026-08-15. Now has automated validation (`scripts/validate_readme.py`) and a strict
+ curation policy (`CURATION.md`).
+- **What it indexes:** An intentionally **selective** guide organised around three pillars: AI foundations, building AI
+ systems, agentic software engineering. Books, courses, papers.
+- **Fit:** Medium-low. An interactive beginner ML platform *can* serve "AI foundations โ high-quality courses and
+ tutorials", but the policy explicitly warns against promotion-driven personal projects and general product
+ directories. Submission must argue differentiation from the strongest existing entry.
+- **Exact place:** `README.md` โ `## Learn` โ `### Courses`, appended.
+- **Contribution requirements (`CONTRIBUTING.md` + `CURATION.md`):** read `CURATION.md`; must serve a pillar; provide
+ evidence (primary source, maintenance status, **your affiliation**); format exactly
+ `- [Resource name](https://example.com/): One factual sentence explaining its value to developers.`; run the three
+ validation commands locally; complete the PR template. Maintainers may decline entries that pass checks but fail the
+ scope/quality policy.
+- **Proposed entry:**
+ ```markdown
+ - [Machine Learning 101](https://machinelearning101.com): A free, browser-based course that teaches core machine learning algorithms through interactive, parameter-driven visualizations.
+ ```
+- **Confidence:** **Medium-Low** (deliberately selective list).
+
+---
+
+## 13. allmachinelearning/MachineLearning
+
+- **URL:** ยท **Stars:** ~3,865
+- **Activity:** Low โ last push 2024-04-01. Chinese-language ML resource index.
+- **What it indexes:** Prerequisites, notes, **courses & talks** (`## ่ฏพ็จไธ่ฎฒๅบง`) by ML/DL/RL, books, miscellaneous.
+- **Fit:** Medium โ an interactive beginner platform fits the courses section, but the repo is stale and mostly Chinese.
+- **Exact place:** `README.md` โ `## ่ฏพ็จไธ่ฎฒๅบง` โ `### ๆบๅจๅญฆไน `.
+- **Contribution requirements:** Has a `## ๅฆไฝๅ ๅ
ฅ How to contribute` section; no strict format; Chinese context
+ preferred.
+- **Proposed entry:**
+ ```markdown
+ - [Machine Learning 101](https://machinelearning101.com) - ๅ
่ดน็ไบคไบๅผๆบๅจๅญฆไน ๅญฆไน ๅนณๅฐ๏ผๅจๆต่งๅจไธญๅจๆๅญฆไน ็ฎๆณใ
+ ```
+- **Confidence:** **Low** (stale + language barrier).
+
+---
+
+## Not recommended / rejected
+
+These were checked and are **not viable** โ do not spend a PR here.
+
+| Repo | Reason |
+|------|--------|
+| [sindresorhus/awesome](https://github.com/sindresorhus/awesome) | README states **PRs are temporarily disabled**. It also indexes lists, not resources. |
+| [sdmg15/Best-websites-a-programmer-should-visit](https://github.com/sdmg15/Best-websites-a-programmer-should-visit) | Repository is **archived**. |
+| [Machine-Learning-Tokyo/Interactive_Tools](https://github.com/Machine-Learning-Tokyo/Interactive_Tools) | Topically ideal (interactive ML tools), but **last merged PR was 2020** โ effectively unmaintained. |
+| [EbookFoundation/free-programming-books](https://github.com/EbookFoundation/free-programming-books) | Organised **by programming language** for books/courses; a standalone platform has no correct section. |
+| [practical-tutorials/project-based-learning](https://github.com/practical-tutorials/project-based-learning) | Requires a **project-based tutorial where the reader builds an artifact**. ML101 is a platform, not a tutorial series; a validator + link checker enforces this. |
+| [hal9ai/awesome-dataviz](https://github.com/hal9ai/awesome-dataviz) | Only accepts **data-visualization libraries** (open-source repos, 50+ stars). ML101 is not a dataviz library. |
+| [lukasmasuch/best-of-ml-python](https://github.com/lukasmasuch/best-of-ml-python) / [krzjoa/awesome-python-data-science](https://github.com/krzjoa/awesome-python-data-science) | Python **software/libraries** only. |
+| [steven2358/awesome-generative-ai](https://github.com/steven2358/awesome-generative-ai) | Main list requires **1,000+ followers**; ML101 would be pushed to `DISCOVERIES.md`. |
+| [natnew/Awesome-Data-Science](https://github.com/natnew/Awesome-Data-Science) | Requires the submitted repo to be **30+ days old and have 60+ stars** โ not met. |
+| [prakhar1989/awesome-courses](https://github.com/prakhar1989/awesome-courses) | **University courses** only; last push 2023. |
+| [kmario23/deep-learning-drizzle](https://github.com/kmario23/deep-learning-drizzle) | Only accepts courses **with lecture videos**. |
+| [dair-ai/ML-YouTube-Courses](https://github.com/dair-ai/ML-YouTube-Courses) | **YouTube-only**; last push 2024-01. |
+| [yrgo/awesome-educational-games](https://github.com/yrgo/awesome-educational-games) | **Educational games** only. |
+| [onmyway133/awesome-machine-learning](https://github.com/onmyway133/awesome-machine-learning) | Explicitly **CoreML/iOS** focused. |
+| [TarrySingh/Artificial-Intelligence-Deep-Learning-Machine-Learning-Tutorials](https://github.com/TarrySingh/Artificial-Intelligence-Deep-Learning-Machine-Learning-Tutorials) | Hosts its **own** lessons; not a directory of external resources. |
+| [mercer/awesome-educate](https://github.com/mercer/awesome-educate) / [brandonhimpfen/awesome-ml](https://github.com/brandonhimpfen) style micro-lists | **Dead/low activity** (<60โ
, last push 2022) โ not worth it. |
+
+---
+
+## How to submit
+
+Submit **one PR per repo** (nearly every list requires this), appending to the bottom of the specified section.
+
+1. **Fork & branch.** Branch like `docs/add-machine-learning-101`.
+2. **Make the minimal edit** exactly in the file/section named above, matching the surrounding bullet style.
+ Do not reorder or reword unrelated entries.
+3. **Self-disclose authorship.** State in the PR body that you are the author/maintainer of Machine Learning 101
+ (required by `academic/awesome-datascience` and `owainlewis/awesome-artificial-intelligence`; encouraged elsewhere).
+4. **Use the project's canonical URL** `https://machinelearning101.com` (not the GitHub repo) unless the list
+ explicitly asks for the source repo.
+5. **Follow each list's mechanical rules:**
+ - `academic/awesome-datascience`, `nuxt/awesome`, `vuejs/awesome-vue`: run the repo's link check / use their PR template.
+ - `practical-tutorials/*` and `owainlewis/*`: run their local validators (`python3 scripts/...`) before opening the PR.
+ - Watch for alphabetical-order requirements (most sections here are append-only; the dataviz list is not relevant).
+6. **Order of attack (best ROI first):**
+ 1. `academic/awesome-datascience` (huge, active, perfect fit)
+ 2. `nuxt/awesome` (native Nuxt showcase)
+ 3. `vuejs/awesome-vue` (native Vue showcase)
+ 4. `TirendazAcademy/Awesome-Data-Science-Resources` and `gs00s/awesome-vue-3` (easy wins)
+ 5. `hamid-moghadam/awesome-interactive-learning` (trivial, on-topic)
+ 6. `josephmisiti/awesome-machine-learning` (`courses.md` + email the maintainer) and `ChristosChristofidis/awesome-deep-learning`
+ 7. Long shots: `owainlewis/...`, `howie6879/mlhub123`, `guillaume-chevalier/...`, `ujjwalkarn/...`, `allmachinelearning/...`
+7. **Track progress** with the companion GitHub issue in this repo
+ (`Submit project to curated awesome-lists and learning directories`).
+
+### Suggested PR body (reusable)
+
+> **Add [Machine Learning 101](https://machinelearning101.com) to ``**
+>
+> Machine Learning 101 is a free, open-source (MIT), browser-based interactive learning platform for machine learning
+> beginners. It runs entirely in the browser with zero setup and lets learners adjust parameters and watch algorithms
+> (regression, classification, clustering, gradient descent, PCA, t-SNE, neural nets) train and update in real time.
+> Built with Nuxt 4 / Vue 3 / TypeScript. I am the project maintainer.
diff --git a/error.vue b/error.vue
index c0795a1..4fc5a20 100644
--- a/error.vue
+++ b/error.vue
@@ -60,6 +60,8 @@