Skip to content

getindiekit/indiekit

Repository files navigation

Indiekit

Indiekit logo.

Build status

Meet Indiekit, the little Node.js server with all the pieces needed to share your content with the open, independent web.

Indiekit’s application management interface.

Sponsors

Indiekit is supported by its community. Special thanks to:

Jon RoobottomKevin YankAbhas Abhinav

Features

  • Publish content to your website using apps and services that support the Micropub API
  • Save files to a content store such as GitHub, an FTP server or S3 object storage
  • Integrate with static site generators like Eleventy, Hugo or Jekyll
  • Share content on social networks like Mastodon
  • Customise everything from the interface theme to the format of commit messages

Indiekit is extensible via its plugin API and localized for use in a growing number of languages.

Requirements

  • Your own website, published using a static site generator
  • Node.js v20+

A MongoDB database is optional, but required for the following features to work:

  • Viewing, editing, deleting and restoring previously published posts
  • Syndicating posts
  • Viewing and deleting previously uploaded media files

Note

This project is known to work with MongoDB v4.4 or later. It may also work with the last openly licenced version, v4.0.3, but this has not been tested.

Get started

Learn how to set up an Indiekit server and view an example server configuration.

Documentation website

The documentation website is generated using VitePress. To view this site locally:

  1. Install this project’s dependencies: npm install
  2. Start the Vite server: npm run docs:dev
  3. View the documentation: http://127.0.0.1:5173

The browser will refresh to reflect any changes you make to the documentation.

Decisions

Architectural decisions made on this project are documented using Architecture Decision Records, as described by Michael Nygard. These can be found in /docs/decisions.

Dependencies

This project aims to keep dependencies up-to-date, however the following dependencies cannot be updated at this time:

Dependency Current Latest Reason
mongodb 4.17.x 6.x.x @keyv/mongo v2.2.8 requires mongodb ^4.5.0
mongodb-memory-server 8.16.x 9.x.x mongodb-memory-server v9.x.x requires mongodb ^5.9.1

Releasing

Lerna is used to manage and publish packages from this monorepo.

To release a new version, use the following command:

npx lerna publish --conventional-commits

Contributing

Read about the different ways you can contribute to this project.

Credits

Developed by Paul Robert Lloyd.

Thank-you to Aron Carroll for mentoring me during the early development of this project. Indiekit is a better project for his feedback and advice.

Similar projects

Indiekit is inspired by similar projects made by members of the IndieWeb community:

About

The little Node.js server with all the parts needed to publish content to your personal website and share it on social networks.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Sponsor this project