hyper-calendarA calendar built around the week

Self-hosted, touch-first, and yours. Run it on a server, or run it entirely on your phone with no server at all.

The week view is the product

Drag, resize and create events with pointer gestures that behave identically with a finger or a mouse. Day, month, year and schedule views sit alongside it.

What it does

Runs on your own infrastructure

One Docker container, an embedded SQLite database, and its own accounts — passwords and passkeys. No identity provider to stand up, nothing more than a TLS-terminating reverse proxy in front.

Self-hosting guide

Or on no infrastructure at all

The Android app bundles the backend and runs it on the device against on-device SQLite. No account, no network, no server. Optionally point it at your own instance instead.

The Android app

The server can be told very little

Event titles, descriptions and locations can be end-to-end encrypted, so a hosted calendar stays readable only to the people you share it with.

Security model

Hyper-Calendar's week view: seven day columns with events laid out across a working week

Where to start

You are…	Start here
using a calendar someone else runs	Using hyper-calendar
installing it on an Android phone	Install on Android
standing up your own instance	Self-hosting · Deployment and operations
working on the code	Development · Architecture

About this site

This is the canonical documentation. It is built from the docs/ directory of the repository with VitePress, so every page here is reviewed in a merge request like the code it describes. The project wiki used to hold much of this and now points here instead.

Two files stay in the repository root, because that is where GitLab surfaces them: CONTRIBUTING.md and SECURITY.md.

The project is licensed AGPL-3.0-only.