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.
There are two ways to run PunctuOwlity. You can open the browser demo directly in any modern browser — no build step or server required — or you can build and install the Android APK using Android Studio. Pick the path that fits your setup below.
Clone the repository
git clone https://github.com/apursley2012/punctuowlity.git
Open index.html in your browser
Navigate into the cloned directory and open index.html directly in any modern browser. No build step and no server are required to run the demo.cd punctuowlity
open index.html # macOS
# or double-click index.html in your file explorer on Windows/Linux
For full localStorage support — especially in browsers that restrict storage for file:// URLs — serving the project through a local HTTP server or deploying it to GitHub Pages is recommended.# Quick local server with Python
python3 -m http.server 8080
Create an account on the Sign Up screen
The app opens on the Login screen. Click the Sign Up link to create a new account. Enter a first name, last name, email, username, and password. Credentials are stored entirely in browser localStorage — no data leaves your device.
Allow or deny browser notifications
After signing up and logging in, the SMS permission screen appears. Click Allow SMS Notifications to enable Web Notifications (the browser will prompt for permission) or No, thanks to skip. Either choice continues to the dashboard.
Explore the events dashboard
The dashboard opens with four seed events already loaded so you can see the two-column card layout right away. Click the floating + button (FAB) in the bottom-right corner to add your first event.
Import the project in Android Studio
Open Android Studio and choose File → Open (or Get from VCS if you want to clone directly). Point it at the android-fixed-source/PunctuOwlityEventTracker directory inside the repository — Android Studio will recognise it as a Gradle project automatically.
Let Gradle sync
Android Studio will download dependencies and sync the project. The app targets Android API 35 (compileSdk 35, targetSdk 35) with a minimum of API 21 (minSdk 21, Android 5.0 Lollipop), so it runs on most modern Android devices and emulators.
Connect a device or start an emulator
Plug in a physical Android device with USB debugging enabled, or launch an AVD from the Device Manager panel. Any emulator image running API 21 or higher will work.
Run the app
Click the Run button (or press Shift + F10). Android Studio will build and deploy the APK. The app launches directly into the Login screen.
Sign up and log in
Tap Sign Up to open the account-creation screen. Fill in your details and tap Create Account. You will be returned to the Login screen — enter your new credentials and tap Login.
Grant or deny SMS permission
The app routes through the SMS permission screen. Tap Allow to grant android.permission.SEND_SMS or Deny to continue without it. The events dashboard loads either way.
Add your first event
The events dashboard opens with the two-column card grid. Tap the floating add button in the bottom-right corner to open the Add Event form. Fill in a title, date, and time, then save — your event appears on the dashboard instantly.
The browser demo ships with four seed events — Project Two Due, Nich’s Birthday, Dentist, and Jessica’s Wedding — pre-loaded into localStorage on first run. They populate the dashboard immediately so you can see the two-column card layout, category labels, and reminder toggles without adding anything yourself.