Add an object to data/tools.json and open a pull request. One PR per tool keeps review simple.

Preview locally: run python scripts/dev_server.py in the repo root and open http://127.0.0.1:8000/ (double-clicking index.html will not load the JSON list). The dev server auto-regenerates detail pages when you edit data/tools.json.

← Directory · Get your badge

Requirements

Open source & source repo required: every tool must have a public source repository (preferably GitHub) linked via source_url. Tools should do most of their work in the browser - single-file HTML, offline-capable tools, or tools with limited network/API calls are preferred. Backend-heavy or login-gated SaaS listings are out of scope.

Schema

Machine-readable schema: data/tool.schema.json

Required fields:

  • id - kebab-case slug (stable forever)
  • name, summary - short card text (summary ≤ 280 chars)
  • url - where users run the tool (https)
  • source_url - public source repository (GitHub or similar)
  • authors - array of { name, url?, github? }

Common optional fields: license, tags, categories, runtime (single_file, offline, needs_network), kind (tool | collection), reference_urls, added (YYYY-MM-DD).