Skip to content
adnfngPublic

About

The open-source profile page that starts with a human.md.

Topics

Resources

Stars

13 stars

Watchers

0 watching

Forks

Repository files navigation

Nomo

Nomo

Your personal site is one markdown file.

Website · Docs · Changelog

A Nomo page

Nomo is a free personal site for developers, made from one markdown file in your GitHub. Make a public repo called .nomo, put a human.md in it, and it's your page at https://nomo.md/your-username. No account, no build step, nothing to host.

AGENTS.md is for your agents. human.md is for humans.

Start

gh repo create .nomo --public --clone --template adnfng/.nomo

Edit human.md, push, and open https://nomo.md/your-username. No terminal? Use the template on GitHub.

Or tell your agent:

Set up my Nomo page. Follow https://nomo.md/AGENTS.md

Or type your GitHub username on nomo.md to see a preview of your page first.

Why

  • You own it. Bento, Read.cv and Polywork shut down and took people's pages with them. A Nomo page is a file in your repo. If Nomo went away you'd still have it.
  • It's markdown. Tabs, photos, galleries, and small and muted text are a few bits of syntax on top. See the syntax.
  • Agents can write it. One file with a short guide is easy for Claude Code, Cursor or Codex to set up and keep current.
  • Machines can read it. Pages are rendered on the server with proper metadata, and nomo.md/you.md returns the source.

Badge

Add this to your GitHub profile README:

[![nomo.md/you](https://nomo.md/badge.svg?user=you)](https://nomo.md/you)

Add &theme=light for a light badge.

Develop

bun install
bun dev

bun run check runs types, lint, tests and a build. See AGENTS.md for how the code is laid out, and .env.example for settings. To preview a local .nomo folder, set NOMO_PREVIEW_DIR and open /preview.

Pull requests are welcome. Anything a user can see gets a line in the changelog.

License

MIT

About

The open-source profile page that starts with a human.md.

Topics

Resources

Stars

13 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages