The repository maintains a curated list of Persian-language YouTube channels organized by topic. It stores channel data as JSON files in the subjects/ directory, each file representing a category (e.g., technology, programming, education). A Node.js script (scripts/index.js) reads these JSON files, combines them with static header and footer templates, and generates a formatted README.md file using the json2md library. The generated README.md is served via GitHub Pages, and a single HTML file (index.html) fetches the markdown, parses it with a custom, scoped markdown parser, and renders an interactive, searchable interface. The client-side code includes language‑agnostic search (with Persian/Arabic normalization), dynamic section navigation, and responsive UI built with vanilla JavaScript and CSS. The project is kept up to date through GitHub Actions workflows that validate the JSON data, regenerate the README, and run code formatting on every push to master. This ensures the list stays accurate and the generated documentation reflects the latest contributions.