Indiekit is a small but powerful server that acts as the go-between your website and the wider independent web. Using IndieWeb protocols and standards, Indiekit lets you:
- publish content to your website using applications like iAWriter, Micro.blog, Icro, Indigenous and other tools that support the Micropub API
accept likes, comments and other feedback on your content using Webmentionssyndicate content to social networks like Twitter, Mastodon and LinkedIn
- Create, update and delete posts
- Upload files
- Configure different post types
- Accept post status and visibility
- Review previously published posts and files
- Bookmarklet to save and share bookmarks
- Publish to different content stores (GitHub and GitLab)
- Support for popular static site generators (Jekyll, Hugo, 11ty)
- Localised to different languages
Plug-in API
- Node.js v12+
npm install @indiekit/indiekit
Read our guide: Setting up your Indiekit server.
If you want to see how Indiekit works, deploy this application to Heroku.
This assumes you’ll be saving files to GitHub and publishing to a Jekyll (or similar) static site generator.
Clicking the button below will guide you through the process.
You’ll be asked to provide the following values:
GITHUB_TOKEN
- A GitHub personal access tokenGITHUB_USER
- Your username on GitHubGITHUB_REPO
- Name of the repository where you want to save filesPUBLICATION_URL
- URL of the website you want to publish to
npm start
If you’re developing a new feature, and want the application to automatically restart whenever a file change is detected, use npm run dev
.
npm test
The following environment variables need to be set before running tests:
TEST_PUBLICATION_URL
TEST_BEARER_TOKEN
TEST_BEARER_TOKEN_NOSCOPE
TEST_BEARER_TOKEN
and TEST_BEARER_TOKEN_NOSCOPE
provide IndieAuth access tokens whose me
value matches that set in TEST_PUBLICATION_URL
.TEST_BEARER_TOKEN
should provide scoped permissions create update delete
, whereas TEST_BEARER_TOKEN_NOSCOPE
should provide no permissions at all.
Homebrew Access Token is a useful tool for creating access tokens for this purpose.
Developed by Paul Robert Lloyd.
Thank-you to Aron Carroll for mentoring me during the development of this project. Indiekit is a much better project for his feedback and advice.
Indiekit is inspired by similar projects made by members of the IndieWeb community, all of which you are encouraged to try: