kodemonaut/komrade
1
0
Fork 0
Code Issues Pull requests Activity
Create a simple dashboard with your Linkwarden, Linkdging or Nextcloud Bookmarks collections
145 commits 1 branch 0 tags 8.1 MiB
  • JavaScript 59.9%
  • CSS 24.9%
  • HTML 11.6%
  • Shell 2.6%
  • Dockerfile 1%
Find a file
devinside 05b00be775 Update README.md
2025-12-03 15:46:50 +01:00
custom change icons-dir 2025-09-22 23:56:52 +02:00
docs docs/config.md aktualisiert 2025-09-27 06:45:14 +02:00
komrade some api points added 2025-09-24 01:43:19 +02:00
.env-example forgot to add the provider back to the example 2025-10-17 18:02:47 +02:00
.gitignore change icons-dir 2025-09-22 23:56:52 +02:00
Dockerfile expose (random generated) port to avoid conflicts with 3000 2025-07-20 08:02:13 +02:00
dockerhub.sh --no-cache flag added for Dockerhub script 2025-05-16 13:18:56 +02:00
install.sh scripts updated to work 2025-05-15 23:38:22 +02:00
jsconfig.json server rewrite in express. Options added to config 2025-05-07 01:14:41 +02:00
LICENSE Update License to GNU 2025-05-13 20:42:01 +02:00
package.json release 0.8.4 2025-09-24 01:43:55 +02:00
README.md Update README.md 2025-12-03 15:46:50 +01:00
update-icons.sh fix of icon-script 2025-05-15 23:45:44 +02:00

README.md

Komrade

Komrade is a simple static startpage/dashboard for your homelab. Instead of complicated YAML configurations, it syncs with the bookmark manager of your choice.

✨ See how it works on YouTube

Video Title

Bookmark sync with:

  • Linkwarden (Collections)
  • Linkding (Bundles)
  • Nextcloud Bookmarks (Folders)

Features

  • Responsive
  • PWA with offline cache
  • Customizable
    • Colors and background image
    • Arrange your categories
    • Sorting
    • Column width
    • Color scheme (Light/Dark)
  • Simple Docker setup via Docker Compose
    • Only a few environment variables are needed to connect to your bookmark manager
    • Simple configuration for the appearance via one TOML file

Documentation

Why?

I really like Homepage and have used it for a while. However, I figured out that most of their incredible features were not useful to me. It is nice to have integrations with the apps of my homelab, but I didn’t really make use of them.

The biggest downside for me personally was that they might never implement a sync feature for bookmark managers, as this is not what it was designed for, and I understand their approach. Homepage is awesome, but it lacked that important feature. Also to keep everything updated felt really like work^^.

Bookmark managers like Linkwarden and Linkding are great, but they honestly lack an overview. They are excellent for managing or even sharing links with other people, but they offer nothing even remotely similar to what Homepage or other dashboards provide. So, I decided to create my own dashboard/startpage project to fill exactly this gap.

It is undeniably inspired by Homepage, but I tried to keep the configuration simple. Another goal I had was to give users more options for customization without creating too much overhead.

Dependencies

Komrade is built on the following dependencies:

  • bun for development and as node-server replacement
  • The official bun:alpine image as base for the docker-image
  • express.js for rendering/middleware
  • nunjucks as template-engine
  • sharp to create thumbnails
  • ninja-keys used as command-panel in the frontend
  • selfhst-icons

Fonts