lastGLANCE

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 85 Open GitHub ↗

When did you last...?

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# lastGLANCE

**when did you last...?** A privacy-first recency tracker for the chores and upkeep that don't fit a calendar. Runs in your browser, with no account and no server unless you bring your own.

Part of the **GLANCE family**: focused, standalone apps connected through a shared intent protocol. See also [dayGLANCE](https://github.com/krelltunez/dayGLANCE) (today), lastGLANCE (recent upkeep), and [lifeGLANCE](https://github.com/krelltunez/lifeGLANCE) (your whole timeline).

[<img src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png" alt="Get it on Google Play" height="75">](https://play.google.com/store/apps/details?id=com.lastglance.app)

[![Version](https://img.shields.io/github/package-json/v/krelltunez/lastGLANCE?color=green&label=version)](https://raw.githubusercontent.com/krelltunez/releases)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://raw.githubusercontent.com/krelltunez/lastGLANCE/main/LICENSE)

---

![lastGLANCE dashboard](https://raw.githubusercontent.com/krelltunez/lastGLANCE/main/public/screenshot.png)

lastGLANCE is a chore-tracking progressive web app that answers one question: *when did I last do this?* It tracks recency, not schedules. The emotional register is information, not guilt.

---

## Android App

A native Android app is available on Google Play and as a direct APK download. The Google Play build is a commercial binary that supports continued development.

[<img src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png" alt="Get it on Google Play" height="60">](https://play.google.com/store/apps/details?id=com.lastglance.app)

[**Download APK from Releases →**](../../releases)

[**Get it on Obtainium →**](https://github.com/ImranR98/Obtainium)
<br> *Just point Obtainium to `krelltunez/lastGLANCE`!*

The Android app ships the full web app in a WebView with native enhancements that aren't possible in a browser:

| Feature | Details |
|---|---|
| 🏠 **Home screen widgets** | A completion heatmap, a "soon" list, the single most-overdue chore, and a quick-add button, each with one-tap done |
| ⚡ **Quick Settings tiles** | An "Add chore" tile and a "Soon" tile that shows a live overdue and soon count right in the notification shade |
| 🔔 **Background reminders** | Overdue notifications fire reliably even when the app is closed |
| 🔗 **Native dayGLANCE intents** | Hand overdue chores to dayGLANCE through the GLANCE intents protocol, with no browser round trip |
| ☁️ **Proxy-free sync** | CapacitorHttp connects straight to WebDAV and Nextcloud with no CORS proxy required |
| 🌗 **Offline-first shell** | The full app runs installable and offline, with dark and light themes |

| Dashboard | Chore detail |
|:-:|:-:|
| ![lastGLANCE Android dashboard](https://raw.githubusercontent.com/krelltunez/lastGLANCE/main/public/screenshot_phone_dashboard.png) | ![lastGLANCE chore detail and history](https://raw.githubusercontent.com/krelltunez/lastGLANCE/main/public/screenshot_phone_detail.png) |

---

## Features

- **Recency tracking**: each chore shows how long ago it was last done, encoded as a color gradient from fresh green through amber to red
- **Cadence**: set a target interval in days; overdue chores sort to the top automatically
- **Categories & subcategories**: organize chores into collapsible groups with custom icons
- **Freeform masonry layout**: category cards size to their content and arrange across columns; your spatial organization is preserved
- **Activity heatmap**: a GitHub-style contribution graph in the header gives an at-a-glance view of completion history
- **Completion history**: per-chore stats (total completions, average interval vs. target), a per-chore contribution graph, and a timestamped log with per-entry notes
- **Backdate entry**: log completions in the past to bootstrap history from day one
- **Reminders**: browser notifications when a chore is overdue (opt-in per chore)
- **Seasonal chores**: hide chores outside their active date range each year
- **Cloud sync**: keep data in sync across devices via WebDAV or Nextcloud (CRDT merge, end-to-end encryption optional)
- **Auto-backups**: periodic remote snapshots (hourly/daily/weekly) in a `backups/` subfolder alongside the sync file
- **dayGLANCE integration**: send overdue chores as tasks to dayGLANCE via WebDAV intents
- **PWA**: installable, works offline, auto-updates
- **Dark/light mode**

![lastGLANCE details view](https://raw.githubusercontent.com/krelltunez/lastGLANCE/main/public/screenshot_details.png)

---

## Tech Stack

| Layer | Technology |
|---|---|
| UI | React 19, Tailwind CSS, Lucide icons |
| Local storage | Dexie (IndexedDB) |
| Sync | `@glance-apps/sync` (WebDAV CRDT engine) |
| Intents | `@glance-apps/intents` |
| Build | Vite 6, TypeScript |
| PWA | vite-plugin-pwa (Workbox) |
| Mobile | Capacitor (Android + iOS) |
| Container | nginx (production), Docker |

---

## Quick Start

### Self-host with Docker

```bash
docker run -d \
  -p 3000:80 \
  --restart unless-stopped \
  ghcr.io/krelltunez/lastglance:latest
```

Or with Docker Compose:

```yaml
services:
  app:
    image: ghcr.io/krelltunez/lastglance:latest
    ports:
      - "3000:80"
    restart: unless-stopped
```

Available at `http://localhost:3000`.

### Self-host (static files)

```bash
npm install
npm run build
# Serve the dist/ folder from any static host (nginx, Caddy, Cloudflare Pages, etc.)
```

> **Note:** lastGLANCE makes WebDAV requests from the browser. If your WebDAV server does not allow cross-origin requests (CORS), you will need the WebDAV proxy (see [Configuration](#configuration)).

### Build from Source

```bash
npm install
npm run dev        # Vite dev server at http://localhost:5173
npm run build      # Production build -> dist/
npm run preview    # Preview production build locally
npm run lint       # ESLint
```

### Mobile apps (Android & iOS)

Native Android and iOS apps are built from the same web build with
[Capacitor](https://capacitorjs.com/):

```bash
npm install
npm run cap:sync       # build dist/ and sync into the native projects
npm run cap:android    # build + sync, then open Android Studio
npm run cap:ios        # build + sync, then open Xcode (requires macOS)
```

WebDAV/Nextcloud sync works without a CORS proxy in the apps thanks to the
CapacitorHttp plugin. See [docs/mobile.md](docs/mobile.md) for details.

---

## Configuration

lastGLANCE is configured entirely in-app. A couple of environment variables are available at build time:

| Variable | Required | Description |
|---|---|---|
| `VITE_WEBDAV_PROXY_URL` | No | Base URL of a [WebDAV CORS proxy](https://github.com/krelltunez/lastGLANCE/tree/main/api) to relay requests when the WebDAV server doesn't allow browser requests directly. Leave unset to use the same-origin proxy bundled with the Docker image. |
| `VITE_WEBDAV_DIRECT` | No | Set to `true` to skip the CORS proxy entirely and connect straight to your WebDAV server from the browser. Use this only when your server sends permissive CORS headers or sits behind a reverse proxy that handles CORS — otherwise sync requests will fail CORS. Leave unset to keep using the proxy. |

Create a `.env.local` for local development:

```env
VITE_WEBDAV_PROXY_URL=https://your-proxy.example.com
```

### WebDAV Proxy

The `api/` directory contains a lightweight server-side proxy (`webdav-proxy.js`) for deployments where CORS is a constraint. It accepts requests at `/api/webdav-proxy/?url=<encoded-target>` and forwards them to the target WebDAV server, stripping the `X-WebDAV-Auth` header into a standard `Authorization` header on the way out.

---

## Sync & Storage

All data is stored locally in IndexedDB (via Dexie). Cloud sync is optional and configured in-app under the **Cloud** button.

**Supported providers:**
- Generic WebDAV (pCloud, Seafile, self-hosted, etc.)
- Nextcloud (uses the native WebDAV endpoint)
- Koofr (self-hosted app recommended; Koofr blocks browser requests from Vercel-hosted origins)

**File layout on the server** (default folder `GLANCE/lastglance`, configurable in sync settings):
```
GLANCE/lastglance/
  lastglance-sync.json      <- live sync file
  backups/
    lastglance-backup-hourly-...json
    lastglance-backup-daily-...json
    lastglance-backup-weekly-...json
```

**Encryption:** end-to-end AES-256-GCM encryption is optional. When enabled, the sync file and all backup files are encrypted before upload. The passphrase never leaves the device, and there is no recovery mechanism, so store it somewhere safe.

---

## Integrations

### dayGLANCE

lastGLANCE can send overdue chores to [dayGLANCE](https://github.com/krelltunez/dayGLANCE) as scheduled tasks via the GLANCE intents protocol. Configure the integration under the **Plug** button.

Two delivery modes are available per chore:
- **Manual**: the -> dG button on a chore card sends it immediately
- **Auto**: the chore is sent once per day whenever it's overdue (requires the intents poller to be running)

---

## Data & Backups

- **Export**: download a full JSON backup at any time from the Archive menu
- **Import**: restore from a local JSON file (replaces all current data)
- **Remote restore**: browse and restore from any auto-backup on your WebDAV server
- **Clear sample data**: remove the example categories and chores from a fresh install (also offered in the welcome modal)

---

## Privacy

lastGLANCE has no backend, no analytics, and no accounts. All data is stored locally on your device. Cloud sync is optional, goes only to a server you control, and can be end-to-end encrypted so the server never sees plaintext.

---

## Contributing

Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for how to run the app locally, project structure, pull request guidelines, and how to report bugs or security issues.

---

## License

The source code is [MIT-licensed](LICENSE): free to build, self-host, modify, and distribute. Free builds (including the sideload APK) are on the [releases page](../../releases).

The paid Google Play / App Store builds are a convenience distribution that funds development: you're paying for the packaged, signed, auto-updating binary, not the code.

The lastGLANCE name, logo, and app icon are trademarks and are not covered by the MIT license.

---

## Support

If lastGLANCE has been useful to you, consider supporting its development:

[![GitHub Sponsors](https://img.shields.io/badge/GitHub_Sponsors-EA4AAA?logo=githubsponsors&logoColor=white)](https://github.com/sponsors/krelltunez)
[![Ko-fi](https://img.shields.io/badge/Ko--fi-F16061?logo=kofi&logoColor=white)](https://ko-fi.com/krelltunez)

lastGLANCE

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README