explaingit

rrantsa/open-source-madagascar

15TypeScriptAudience · generalComplexity · 1/5ActiveSetup · easy

TLDR

Curated catalogue of open source projects relevant to Madagascar, organised by category and backed by a JSON dataset and a GitHub Pages browser.

Mindmap

mindmap
  root((open-source-madagascar))
    Inputs
      Repository submissions
      JSON schema
      Category Markdown
    Outputs
      Curated directory
      Statistics block
      GitHub Pages site
    Use Cases
      Find local OSS
      Avoid duplicate work
      Civic tech discovery
    Tech Stack
      Markdown
      JSON Schema
      TypeScript
      GitHub Pages

Things people build with this

USE CASE 1

Find existing open source projects relevant to Madagascar before starting a new one

USE CASE 2

Submit a project to a curated Malagasy OSS directory using the documented entry format

USE CASE 3

Browse civic tech, agriculture, or payments OSS for the Madagascar context

Tech stack

MarkdownJSON SchemaTypeScriptGitHub Pages

Getting it running

Difficulty · easy Time to first run · 5min

Awesome-list style repository; no install, just read or submit entries.

In plain English

Open Source Madagascar is a curated list of open source projects that are useful for Madagascar. It is not a software product in itself. The repository acts as a directory, pointing to other repositories, datasets, libraries, and starter kits that are either built by Malagasy developers or adapted to the local context. The README frames it as a starting point for a shared digital commons. The stated goal is to make it easier to find, reuse, and improve work that already exists, instead of duplicating effort across separate teams. The categories listed in the README cover areas the maintainers see as important for Madagascar, including payments, delivery and addressing, education, public services, health, agriculture, mobility, civic tech, Malagasy language and AI, datasets, and offline-first applications. Each category has its own Markdown file under categories/. The project pairs the human-readable README with a machine-readable data file at data/repositories.json, validated against a JSON schema in the same folder. A statistics block in the README is generated from that JSON and currently reports 26 listed repositories across 14 of the 18 categories, with licence breakdowns and an activity status for each entry. There is also a companion site published through GitHub Pages that presents the same catalogue in a browsable form. The README is mostly about contribution rules rather than code. It links to a contribution guide, a roadmap, a product requirements document, a canonical Markdown format for new entries, a maintainer review checklist, a label guide, and a manual pull request validation workflow. New project submissions are expected to follow the entry format and must be open source and clearly relevant to Madagascar. Documentation may be in English, French, or a mix of both.

Copy-paste prompts

Prompt 1
Add my repo to open-source-madagascar following the entry format and validate it against the JSON schema
Prompt 2
Generate the statistics block in the README of open-source-madagascar from data/repositories.json
Prompt 3
Fork open-source-madagascar and adapt it to be a curated directory for another country, keeping the validation workflow
Prompt 4
Walk me through the maintainer review checklist and the PR validation workflow in open-source-madagascar
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.