Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/apursley2012/PunctuOwlity/llms.txt

Use this file to discover all available pages before exploring further.

PunctuOwlity is an event-tracking application built around a simple idea: important dates should be easy to add, easy to scan, and easy to remember. It ships as a native Android app with SQLite persistence and as a pixel-faithful static web app that runs entirely in the browser — no server required.

Quick Start (Web)

Run PunctuOwlity in your browser or deploy it to GitHub Pages in minutes.

Quick Start (Android)

Build and run the Android app locally with Android Studio.

Event Management

Add, edit, delete, and browse events with titles, dates, times, and categories.

Account Management

Create accounts, log in with username or email, and manage sessions locally.

What PunctuOwlity Does

PunctuOwlity gives users a two-column card grid of upcoming events. Each card shows the abbreviated weekday, the day number in large type, the event title, the time (or “ALL DAY”), and a reminder icon. Users can filter by category — Birthdays, Appointments, Trips — or search by title. Adding or editing an event takes a single screen with three fields: title, date, and time.

Search & Filters

Filter events by category and search by title in real time.

Reminders

Toggle reminders per event; browser notifications fire for same-day events.

Architecture Overview

Understand how the web and Android versions relate to each other.

Data Storage

See how events and accounts are stored in SQLite (Android) and localStorage (web).

Get Started in Three Steps

1

Open the app

Visit the hosted web app or clone the repo and open index.html directly in your browser. The login page loads first.
2

Create an account

Click Sign Up, fill in your name, email, username, and password. Duplicate usernames and emails are rejected automatically.
3

Add your first event

After logging in, tap the button, enter an event title, pick a date and time, optionally enable a reminder, and save. Your event appears on the grid immediately.
PunctuOwlity stores all data in the browser’s localStorage. No data is sent to any server, and no backend is required to run the web version.

Build docs developers (and LLMs) love