Klarbild 1.0.0 — first public release
CI / check (push) Has been cancelled

A self-hosted print studio: images at exact physical sizes, sheet layout with
crop marks, tiling, 1:1 PDF. Everything else — image generation, delivery,
share links, mail, Telegram — is an optional module that is off by default.

This is the neutral public twin of a private tool. Compared to that original:

- optional modules behind KLARBILD_MODULES; the default install is print-only
- English interface with German as a full second language (1,038 strings);
  the English sentence is the translation key
- no built-in accounts — first boot creates one admin from ADMIN_USERNAME /
  ADMIN_PASSWORD, or generates a password and logs it once
- delivery and backup targets are generic SFTP/FTPS endpoints, off by default
- English routes, English identifiers, English comments throughout
- two compose files: print-only by default, everything in the full one
- AGPL-3.0, CI (build, tests, type check, secret scan), CONTRIBUTING, SECURITY

124 tests green, type check clean, verified end to end against a live instance.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Nh4A79bbqT9dcd2inzYUdg
This commit is contained in:
tillandClaude Opus 5 committed 2026-09-15 14:52:41 +00:00
commit e2481139a1
164 files changed
+27190

No files matched your search

+35
View File
@@ -0,0 +1,35 @@
# Changelog
## 1.0.0 — first public release
The first open-source release of Klarbild. Everything before this lived in a
private repository as a personal tool.
**New in the public version**
- **Optional modules.** `KLARBILD_MODULES` decides what an instance is. The
default is the print studio alone — no image model, no object store, no bot
token, no account anywhere. See `src/lib/modules.ts`.
- **English interface**, with German as a full second language. The English
sentence is the translation key; 1,038 strings.
- **First-run setup.** No built-in accounts. The first boot creates one
administrator from `ADMIN_USERNAME` / `ADMIN_PASSWORD`, or generates a password
and prints it once to the log.
- **Two compose files.** `docker-compose.yaml` is the print-only stack (app plus
Postgres, files on a volume); `docker-compose.full.yaml` adds MinIO and every
module.
- **Delivery is generic.** The delivery and backup targets are plain SFTP/FTPS
endpoints you configure, switched off by default.
- English routes: `/print`, `/library`, `/queue`, `/shares`, `/help`, `/account`,
`/tour`, `/password`.
- AGPL-3.0, CI (build, tests, type check, secret scan), `CONTRIBUTING`, `SECURITY`.
**Carried over from the private tool**
The print engine as it stands: 86 image sizes in 10 groups, 19 paper formats
including A3+ and photo paper, corner marks and continuous lines, bleed 0–10 mm,
crop or letterbox per picture, oversize as fit / overflow / tile with glue flaps
and page numbers, captions in six positions, duplicate cells, presets, and a run
history that stores the instructions rather than the PDF. Plus the optional
modules: image generation, delivery, backup mirror, share links, mail, Telegram,
and an MCP server for assistants.