Home / Submit a project

Built something on Jev? Add it.

One way in: a pull request that adds one line to readme.md. Under five minutes, nothing to install.

Add one line by pull request

- [name](https://github.com/owner/name) - One sentence, uppercase start, period end.edit/main/readme.md

Open readme.md in the GitHub editor. GitHub forks the repo for you.
Find the most specific section and add your line at its bottom, in the format above.
Open the pull request. The template asks for the section, your relation to the project, and three checks. CI checks the format; a person reads the rest.

Why a pull request and not an issue

A pull request is the line itself: your name in the history, the checks run on it, the review is a diff. An issue asks a maintainer to write the line for you, and that queue is where lists go stale.

The bar

The bar is low on purpose. An entry must:

Call the Jev API, or be a documented replica of the System One interface on open models.
Be a public repo or page with a readme that says what it does.
Actually run. A stubbed API call, a hard-coded demo, or a readme with no code does not count.
Do nothing shady: no credential harvesting, no obfuscated payloads, no miners, nothing that phones home beyond the APIs it documents.
Not be archived, and not already be listed.

Listed? Add the badge to your readme

[![Listed in Awesome Jev](https://awesomejev.vercel.app/badge.svg)](https://awesomejev.vercel.app)

Thanks for keeping the list worth reading. Everything else lives in contributing.md.