Skip to content
antonsxhPublic

About

A calm, dark, self-hosted planner that ties every hour to a few quests — plan your week, run focus sessions, review where the time went. Web, iPhone/iPad (PWA) and desktop app.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

42 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

libe

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.

Run with Docker

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.

HTTPS (needed for iPhone/iPad, service worker and secure cookies)

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 -d

Behind 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;).

iPhone / iPad (home-screen app)

  1. Open your libe https URL in Safari.
  2. Share → Add to Home Screen → Add.
  3. 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).

Desktop app (Tauri 2)

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/nightly

As a system package, with updates through nix flake update libe or system.autoUpgrade: docs/NIXOS.md.

Develop

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 secret

See AGENTS.md for conventions, docs/ROADMAP.md for the plan and CONTRIBUTING.md for how to contribute — issues and pull requests are welcome.

About

A calm, dark, self-hosted planner that ties every hour to a few quests — plan your week, run focus sessions, review where the time went. Web, iPhone/iPad (PWA) and desktop app.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages