bwlng / indiekit

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

Home Page:https://getindiekit.com

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Indiekit

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, GitLab or an FTP server
  • Integrate with static site generators like Jekyll or Hugo
  • Share content on social networks like Twitter and 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 v18+

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 Jekyll’s 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.

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 development of this project. Indiekit is a much better project for his feedback and advice.

Similar projects

Indiekit is inspired by similar projects made by members of the IndieWeb community, all of which you are encouraged to try:

About

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

https://getindiekit.com

License:MIT License


Languages

Language:JavaScript 81.1%Language:Nunjucks 11.9%Language:CSS 6.8%Language:HTML 0.1%Language:Dockerfile 0.1%Language:Shell 0.0%