discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens

Achyuth072/kagelin · source

Snapshot 0 · 2026-11-04T12:47:28Z · TypeScript · AGPL-3.0

GitHub description at capture

An ink & matte style productivity app

README at capture

<p align="center">
  <a href="https://kagelin.app">
    <img src="https://raw.githubusercontent.com/Achyuth072/kagelin/main/public/kagelin-icon.png" width="80" alt="Kagelin" />
  </a>
</p>

<div align="center">

# Kagelin

## Work quietly. Own everything

[![License: AGPL-3.0](https://img.shields.io/github/license/Achyuth072/kagelin?style=flat&labelColor=24292e)](LICENSE)
[![CI](https://img.shields.io/github/actions/workflow/status/Achyuth072/kagelin/ci.yml?branch=main&style=flat&label=CI&logo=github&logoColor=white&labelColor=24292e)](../../actions/workflows/ci.yml)
[![Deployed on Vercel](https://img.shields.io/github/deployments/Achyuth072/kagelin/production?style=flat&label=deployment&logo=vercel&logoColor=white&labelColor=24292e)](https://kagelin.app)

[![Stable](https://img.shields.io/github/v/release/Achyuth072/kagelin?style=flat&label=Stable&labelColor=06599d&color=043b69)](../../releases)
[![Preview](https://img.shields.io/github/package-json/v/Achyuth072/kagelin/dev?style=flat&label=Preview&labelColor=2c2c47&color=1c1c39)](../../releases)

[![Sponsor](https://img.shields.io/github/sponsors/Achyuth072?style=flat&logo=githubsponsors&labelColor=24292e)](https://github.com/sponsors/Achyuth072)
[![Ko-fi](https://img.shields.io/badge/Ko--fi-support-FF5E5B?style=flat&logo=kofi&logoColor=white&labelColor=24292e)](https://ko-fi.com/oneakira)

## Use it

**[app.kagelin.app](https://app.kagelin.app)** — installable as a PWA, works fully offline in guest mode. No account needed.

_Currently in preview — expect rough edges._

</div>

## Screenshots

<p align="center">
  <img src="public/screenshots/board-view-desktop.webp" alt="Board view" width="47%" />
  &nbsp;
  <img src="public/screenshots/habit-grid-desktop.webp" alt="Habit grid" width="47%" />
</p>
<p align="center">
  <img src="public/screenshots/timer-with-task.webp" alt="Focus timer" width="47%" />
  &nbsp;
  <img src="public/screenshots/calendar-monthly.webp" alt="Calendar monthly view" width="47%" />
</p>
<p align="center">
  <img src="public/screenshots/command-pallete-desktop.webp" alt="Command palette" width="70%" /><br />
  <sub>Command palette (Ctrl/Cmd+K)</sub>
</p>

## Why Kagelin

Most productivity apps want your email before you've written a single task, and keep your data on their servers either way. Kagelin doesn't.

- **Nothing to sign up for.** Tasks, habits, focus, and calendar — all offline in guest mode. Account only if you want cloud sync.
- **Your data, your server.** Guest mode keeps everything on your device, and backs up to your own Nextcloud, Synology, or any WebDAV server. No middleman.
- **Take everything with you.** Encrypted ZIP export, full data deletion, and standard `.ics` files. Leaving is always an option.

## Features

- **Tasks**: Board and List views, projects, recurring tasks, steps, Todoist import and export, and Vim-style keyboard navigation.
- **Focus & habits**: a Pomodoro timer that follows you across devices, habits with flexible frequencies and reminders, and Loop Habit Tracker import and export.
- **Calendar**: month, week, and multi-day views, Google and Outlook sync, event reminders, and `.ics` import and export.
- **Reminders**: push notifications for tasks, events, and habits, plus a morning brief and an evening plan.
- **Data ownership**: guest mode, zero-knowledge encryption with key rotation, WebDAV backup, and full export.
- **Stats & insights**: period breakdowns, per-habit insights, and goal tracking.

See the [full feature list](docs/features.md).

## Shortcuts

| Shortcut        | Action                                                            |
| --------------- | ----------------------------------------------------------------- |
| `1–6`           | Quick navigation (Home, Habits, Calendar, Stats, Focus, Settings) |
| `Shift+1 / 2`   | Switch view (Board / List)                                        |
| `gg / G`        | Jump to top / bottom of task list or board                        |
| `yy / p / u`    | Yank task / paste task / undo action                              |
| `Ctrl/Cmd+K`    | Open Command Palette                                              |
| `Ctrl/Cmd+B`    | Toggle Sidebar                                                    |
| `N / H / E / P` | Create new (Task, Habit, Event, Project)                          |
| `? / Shift+H`   | View all shortcuts                                                |

<details>
<summary><strong>Stack</strong></summary>

- **Next.js 16.4.0** (App Router) + **React 19.3.0** (React Compiler)
- **Supabase** (Postgres, Auth, Realtime)
- **TanStack Query v5** (IndexedDB persistence) + **Zustand v5**
- **Tailwind CSS v4** + **Shadcn UI** (Radix)
- **Framer Motion** + **@dnd-kit** (flat-DOM drag-and-drop)
- **Serwist** (typed service worker, offline-first PWA)
- **tsdav** (CalDAV, currently deferred) + **ical.js** (ICS import/export)
- **libsodium-wrappers-sumo** (zero-knowledge content encryption)
- **sql.js** (uhabits `.db` import/export)

</details>

## Setup

**Prerequisites**: Node.js 24+, a Supabase project with the schema from `supabase/schema.sql` and relevant migrations from `supabase/migrations`.

```bash
git clone https://github.com/Achyuth072/kagelin.git
npm install
cp .env.example .env.local   # add all relevant keys
npm run dev
```

## Contributing & Feedback

Before opening a PR, read [CONTRIBUTING.md](CONTRIBUTING.md) — all PRs must target the `dev` branch, not `main`.

Bug reports and feature requests go in [GitHub Issues](../../issues). For questions and discussion, use [GitHub Discussions](../../discussions).

## License

<pre>
Copyright © 2026 Achyuth S.

Licensed under the GNU Affero General Public License, Version 3.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.gnu.org/licenses/agpl-3.0.en.html

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
</pre>