How Indiekit works
Let’s say you have installed Indiekit on your web server, and set it up so that it can be reached at
Any application that supports the Micropub protocol can make the following
POST request to
POST /micropub HTTP/1.1 Host: indiekit.mywebsite.com Content-Type: application/x-www-form-urlencoded Authorization: Bearer XXXXXXX h=entry &content=Hello+world
Indiekit will recognise this as a Micropub request and create a new note post with the content ‘Hello world’.
If you’ve configured Indiekit to publish files to GitHub for a site generated using Jekyll, Indiekit will create the following file and commit it to your repository at your specified location:
--- date: 2021-02-15T21:38:25.343Z mp-syndicate-to: - https://twitter.com/username - https://mastodon.social/@username --- Hello world
Assuming your publication is deployed every time there is a new commit, this new post will appear on your website (this may take a few minutes if you’re using a static site generator).
Sharing content with third-party websites
mp-syndicate-to property in the above example. If you’ve configured Indiekit to syndicate to third-party websites they will appear in this list.
You can then send a second
POST request, this time to
https://indiekit.website.example/syndicate along with your access token which you can find on your server’s status page:
POST /syndicate HTTP/1.1 Host: indiekit.mywebsite.com Content-Type: application/x-www-form-urlencoded token=XXXXXXX
This will tell Indiekit to syndicate the most recent un-syndicated post to the third-party websites listed in the front matter.
Use an outgoing webhook on Netlify
Netlify allows posting to an outgoing webhook once a deploy has succeeded.
In ‘URL to notify’, enter your server’s syndication endpoint with your access token as the
token parameter, for example:
Once this has been completed, Indiekit will update the post, replacing
mp-syndicate-to with a
syndication property listing the location of each syndicated copy:
--- date: 2021-02-15T21:38:25.343Z syndication: - https://twitter.com/username/1234567890 - https://mastodon.social/@username/1234567890 --- Hello world
Notifying other websites that you’ve mentioned
Indiekit is in the early stages of development so only supports the Micropub protocol and post syndication for now. Future releases may add support for Webmention and other IndieWeb standards.