A tiny corner of the web, built by Joshes

Join the Joshternet.

Are you a Josh? Get yourself connected. Non-Joshes are equally welcome. You declare your identity; we never infer it from a name or a website.

Publish in any written language. Declaration keys stay exactly version and josh.

No accounts. No signup form. Your site stays yours.

First, pick what feels right

Choose your identity

Copy one version 1 declaration and publish it on your own site.

01 / IDENTITY

Affirmed Josh identity

You are a Josh. Say so proudly.

/.well-known/josh

{
  "version": 1,
  "josh": true
}

02 / IDENTITY

Declined Josh identity

Still a full participant. You can joshing the Joshes from day one.

/.well-known/josh

{
  "version": 1,
  "josh": false
}

03 / IDENTITY

Undeclared identity

Leave identity open. Joshternet never guesses from your name or site.

/.well-known/josh

{
  "version": 1
}

Use a recipe or do it your way

Put it on your site

Serve the file at exactly /.well-known/josh on your origin, with a public 200. Each origin needs its own file, including www when it is separate.

Cloudflare WorkerServe it at the edge ↗ AstroCopy from public/ ↗ EleventyPassthrough copy ↗ GhostServe from your proxy ↗ HugoPublish from static/ ↗ JekyllInclude the file ↗ Next.jsUse public/ ↗ NuxtUse public/ ↗ QuartzCopy after build ↗ SvelteKitUse static/ ↗ WordPressUse the plugin ↗ Any other siteGeneric static recipe ↗

Make sure it works

Validate

Confirm your live file parses. Passing means the declaration is valid when read; it does not mean JoshBot has listed your site.

Open the declaration checker ↗

Discovery is optional

Ask JoshBot to look

A nomination requests discovery. It does not create participation or guarantee a listing.

Nominate your site ↗