Contribute
Help build the directory
The directory is open source and lives in plain text files. 122 products so far — every addition makes it more useful.
Ways to contribute
- 01
Suggest a product
No Git needed. The form prepares a GitHub issue or an email. Include where the company is registered and where data is hosted.
Suggest a product - 02
Correct an entry
Use “Report an error” on any product page, or edit the file directly on GitHub. Corrections need a source.
Report a correction - 03
Add or edit entries
Every product, company and category is one small text file. Copy the template, fill in what you can verify, open a pull request. The build checks every reference.
Content guide - 04
Logos
Vendors and contributors can provide official logos (SVG preferred). They are normalised to a common format.
Logo guidelines - 05
Translate
The site is available in English and German and prepared for French and Italian. Interface text lives in one dictionary per language.
Translation guide - 06
Improve the code
Astro, TypeScript and plain CSS — no framework, minimal JavaScript. Run npm run verify before opening a pull request.
Contributing guide
From URL to pull request
Adding an entry takes a few minutes with the import helper. Verifying the facts takes longer — and matters more.
- Start from a URL.
npm run new -- https://example.chreads the website (and a GitHub repository, if given) and drafts an entry: name, description, languages, imprint and privacy links, the Swiss company register number and its registered seat. - Verify and complete. Fill in ownership, development and hosting from the vendor’s legal pages. Mark each claim as verified, vendor or inferred and link the source. Leave anything you cannot confirm as unknown.
- Check.
npm run verifyvalidates the schema, every reference and the listing criteria, and lints the text. - Open a pull request. A maintainer reviews the sources. Automated research help can be requested on an issue by mentioning
@claude.
Open data
Everything on this site is also available as static JSON, regenerated with every build. Reuse it with attribution.
- /data/products.json
- All products with company, footprint, hosting, pricing, open-source status and features.
- /data/directory.json
- The full graph: products, companies, categories, groups and the foreign products they replace.
- /search-index.json
- The search index used by the site.
- /latest/rss.xml
- RSS feed of new entries.
- Licence
- Directory data: CC BY 4.0 · Code: MIT · Logos and product names remain trademarks of their owners.