A calm, dark planner that ties every hour to a few quests. SvelteKit 3 · Svelte 5 · Bun · Drizzle + Postgres · Docker Compose · Tauri 2 desktop shell · installable on iPhone/iPad as a home-screen web app.
cp .env.example .env # set LIBE_SETUP_SECRET (openssl rand -base64 24)
docker compose up -d # pulls ghcr.io/antonsxh/libe:stable
# → http://localhost:3000 (migrations run automatically on start)Images (linux/amd64 + arm64) are published by the release pipeline: :stable / :latest
(newest stable release), :nightly (at most every 6 h when main changed), and exact
versions (:0.2.0, :0.2, :0.2.1-nightly.20261119.12). Pick one with LIBE_IMAGE in
.env; update with docker compose pull && docker compose up -d. docker compose up --build
builds the checkout instead. Releases, channels and desktop installers:
docs/RELEASING.md.
Open the app, you land on /setup: enter LIBE_SETUP_SECRET and a name for this device.
Every other device (browser, phone, desktop app) is then paired with a short code: on a paired
device open the avatar menu → Pair new device, and type the 6-digit code (or scan the QR
code) on the new one. There are no user accounts or passwords — devices are the sign-in.
Paired devices are listed (and can be renamed or revoked) under Settings.
/setup stays available as a recovery path if you lose every paired device — whoever knows
the server's secret owns the server anyway. Unset LIBE_SETUP_SECRET to switch it off
(compose.yaml requires it, so comment it out there too).
Env overrides: POSTGRES_PASSWORD, LIBE_PORT, LIBE_ORIGIN, TZ, LIBE_SETUP_SECRET, LIBE_IMAGE.
The easiest way is the bundled Caddy overlay, which gets a Let's Encrypt certificate:
# .env: LIBE_DOMAIN=libe.example.com (DNS → this host, ports 80/443 open)
docker compose -f compose.yaml -f compose.caddy.yaml up -dBehind your own reverse proxy instead: set LIBE_ORIGIN=https://libe.example.com (→ the
app's ORIGIN). SvelteKit derives the request protocol from ORIGIN, so the device cookie
gets Secure and form posts pass the CSRF check. Alternatively set PROTOCOL_HEADER=x-forwarded-proto
and HOST_HEADER=x-forwarded-host and make sure the proxy sends them. For correct client IPs
in the pairing rate limit set ADDRESS_HEADER=X-Forwarded-For and XFF_DEPTH=1 (one proxy).
The timer is a server-sent event stream: disable response buffering for /api/timer/stream
(Caddy does this automatically; nginx: proxy_buffering off;).
- Open your libe https URL in Safari.
- Share → Add to Home Screen → Add.
- Open libe from the home screen and pair it there (enter a code from a paired device, or scan the QR code with the Camera app and then continue inside the home-screen app). The home-screen app has its own cookie store, separate from Safari, so it is paired as its own device (shown as "Home-screen app" in Settings).
The app runs full-screen (dark status bar, safe-area aware), keeps the timer in sync when you come back to it, and shows an offline page when the server can't be reached.
Notifications (iOS 16.4+): in the home-screen app open Settings → Notifications → Turn on notifications and allow them. libe then tells you when a focus countdown or a pomodoro phase ends, and the app icon shows today's open tasks. Needs HTTPS; nothing to configure on the server (its push keys are generated on first use).
A thin native window around your server (macOS, Windows, Linux) that keeps its device token in the OS keychain. Installers (unsigned) are attached to every GitHub release. Build instructions, pairing and limitations: docs/TAURI.md.
NixOS (x86_64, aarch64): the repository is a flake, with released builds in the binary
cache libe.cachix.org:
nix run github:antonsxh/libe/channel/stable # or channel/nightlyAs a system package, with updates through nix flake update libe or system.autoUpgrade:
docs/NIXOS.md.
bun install
cp .env.example .env # LIBE_SETUP_SECRET=dev-setup-secret is fine locally
bun run db:dev # or: docker compose up -d db
bun run db:migrate
bun run dev # → open /setup, enter the secretSee AGENTS.md for conventions, docs/ROADMAP.md for the plan and CONTRIBUTING.md for how to contribute — issues and pull requests are welcome.