Dotplan Online

What is Dotplan?

Dotplan is an API specification through which the technically capable can express their personalities (or lack thereof) with one another. A modern, decentralized re-imagining of the Unix plan file. It uses minisign to verify authenticity.

What is Dotplan Online?

This site is a free Dotplan provider and relay running the Dotplan reference implementation. If you're incapable of hosting your own (or too lazy), you can point your email domain here via a SRV record and use it as your Dotplan provider.

How does it work?

Dotplan API

Fetch the plan for [email protected] as plain text:

    curl https://dotplan.online/plan/[email protected]

Fetch the plan for [email protected] as JSON:

    curl -H 'Accept: application/json' \
      https://dotplan.online/plan/[email protected]

See the GitHub for more details, such as how to verify signed plans.

Dotplan Online

Register the email address [email protected] with password my-password-123 (an email with further instructions will be sent):

    curl -H 'Content-Type: application/json' \
      -XPOST -d '{"password":"my-password-123"}' \
      https://dotplan.online/users/[email protected]

Retrieve an authentication token for the account created above:

    curl -H 'Accept: application/json' \
      -u '[email protected]:my-password-123' \
      https://dotplan.online/token

Update the plan for [email protected] with the authentication token retrieved above:

    curl -H 'Content-Type: application/json' \
      -XPUT -d '{"auth":"AUTH_TOKEN","plan":"This is my first plan!"}' \
      https://dotplan.online/plan/[email protected]

See the GitHub for more details, such as how to sign plans for authenticity and how to support service discovery via domain SRV records.

What's the point?

I like the idea of plan files, and wanted one that I could easily update and inject into my static website using javascript. This was the result.

The Dotplan Online source code is licensed under the WTFPL.

Privacy policy: Dotplan Online collects whatever you send it via the API. Dotplan Online shares your plan contents with anyone who requests it via the API. It does not share any other data, personally identifiable or otherwise, with anyone else.

Terms: This was a silly weekend idea and I can't guarantee this site or the associated service will stick around. If I'm made aware of inappropriate content in a plan I reserve the right to remove it and terminate the associated accounts. If you like this idea and don't want to worry about any of that, you could (and should!) host your own.