Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Empty file added docs/.nojekyll
Empty file.
110 changes: 110 additions & 0 deletions docs/APP_STORE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,110 @@
# Publishing Pagemark on the App Store

Paste-ready answers for App Store Connect. Keep them in step with `docs/PRIVACY.md` and the app (the iPhone build has no updater, folder backup or widget).

## Build and upload (on the Mac)

1. Pull `ios-first-build` (later `main`), `flutter pub get`, `cd ios && pod install`.
2. Xcode → Runner → Signing & Capabilities: pick your team (bundle id `com.axialforge.pagemark`).
3. `flutter build ipa --release`, then upload `build/ios/ipa/*.ipa` with Transporter (or Xcode → Organizer).
4. TestFlight first: check Face ID/Touch ID unlock, the blank app switcher on the Locked tab, a reminder, and a backup + restore.

## App information

- **Name (30):** Pagemark: Reading Log
- **Subtitle (30):** Private book tracker & journal
- **Category:** Primary **Books**, secondary **Lifestyle**.
- **Bundle ID / SKU:** `com.axialforge.pagemark` / `pagemark-ios`
- **Content rights:** No third-party content. Book details and covers come from Open Library and Google Books at the user's request.
- **Copyright:** © 2026 AxialForge
- **Privacy policy URL:** `https://axialforge.github.io/Pagemark/privacy.html` (needs GitHub Pages on, `main` / `/docs`).
- **Support URL:** `https://github.com/AxialForge/Pagemark/issues`
- **Price:** Free. No in-app purchases.

## Version page

**Promotional text (170):**
A private reading log that lives only on your phone. No account, no ads, no tracking and no AI. Your books, ratings and thoughts never leave your iPhone.

**Keywords (100, comma-separated, no spaces):**
`reading log,book tracker,reading journal,manga,audiobook,tbr,quotes,library,isbn,scanner,stats,goal`
(Don't add competitor names such as Goodreads or StoryGraph; Apple rejects them.)

**Description:**

Pagemark is a book tracker that keeps everything on your phone.

LOG EVERY READ
• Print, e-book and audiobook, with dates, half-star ratings and private thoughts
• Re-reads are kept as separate reads, so nothing gets overwritten
• Save favourite quotes and set a yearly reading goal

ADD BOOKS IN SECONDS
• Scan the barcode or search by title, author or ISBN
• Covers and details come from Open Library (and Google Books, which you can switch off)
• Import your history from a CSV export of another reading app

MANGA, COMICS AND SERIES
• Track collections volume by volume: what you own, what you have read and what you still need

YOUR STATS
• Books per month, ratings, pages and listening time, and your year in books

A LOCKED LIBRARY
• Keep some books behind a PIN or Face ID / Touch ID
• Locked books stay out of stats, search and exports, and the app switcher shows a blank screen while they are open

YOUR DATA STAYS YOURS
• No account, no ads, no analytics, no tracking and no AI
• Save a password-protected backup wherever you like (Files, iCloud Drive, email), with a reminder to do it
• Export your log as CSV or JSON at any time

Pagemark never collects your data. The code is public.

**What's New (first release):**
First iPhone release of Pagemark.

## Age rating

Answer **None / No** to every content question (no violence, sexual content, profanity, gambling, medical, etc.). Unrestricted web access: **No** (the app only queries book catalogues). User-generated content shared with others: **No**. Expected rating: **4+**.

The optional "heat level and content notes" fields are a private diary entry, off by default, with no content provided by the app. They don't change the answers above.

## App Privacy ("nutrition label")

**Recommended answer: "Data Not Collected".**

Why this is accurate under Apple's definitions:
- AxialForge has no server and receives nothing. There are no analytics, ads, crash-reporting or tracking SDKs (a test in the project enforces this).
- Library data, ratings, thoughts, PIN hash and backups stay on the device, or go only where the user saves them.
- Book searches go straight from the phone to Open Library / Google Books to answer that one request. Apple does not count data used only to service a request in real time as "collected", and neither service is a partner of the developer.
- On iPhone the barcode reader is Apple's on-device Vision framework. Unlike Android, no Google ML Kit is involved.

More conservative alternative, if you'd rather declare the lookups: **Search History**: *not linked to the user*, *not used for tracking*, purpose **App Functionality**. Don't mix the two: either "Data Not Collected" or this one entry.

Tracking: **No** (no ATT prompt needed). The privacy manifest `ios/Runner/PrivacyInfo.xcprivacy` already says the same.

## Export compliance

`ITSAppUsesNonExemptEncryption = false` is set in `Info.plist`, so App Store Connect won't ask on each build. Reason: encryption is used only for HTTPS and to protect the user's own backup files (exempt).

## App Review notes

> Pagemark is a local reading log with no account or login. To test: tap + to add a book (search "Dune" or scan any book barcode). The Locked tab asks you to set a PIN; any PIN works and a recovery code is shown. No server; the only network calls are book lookups to openlibrary.org and googleapis.com (Google Books).

Demo account: not needed. Contact: your name, email and phone (App Store Connect only, not public).

## Screenshots

- Required: **6.9" iPhone** (1320 × 2868 or 2868 × 1320), 3 to 10 images. Smaller sizes are scaled from it.
- iPad: not needed (the app is iPhone only, `TARGETED_DEVICE_FAMILY = 1`).
- Capture on the 6.9" simulator (iPhone 16/17 Pro Max) with the seeded demo library (`docs/_tools/screenshots/README.md`). Use a `--dart-define=PAGEMARK_SCREENSHOTS=true` build for the Locked tab, and never ship that build.
- Suggested set: Library (cover wall), Book page with a read, Stats, Add book / scanner, Series volumes, Locked tab.
- Don't show Android UI, "fingerprint" wording or the Updates screen (Apple rejects references to other platforms).

## Before you submit (open items)

- [ ] GitHub Pages on, and the privacy URL opens.
- [ ] Signing team set; TestFlight build tested on a real iPhone (checklist in "Build and upload").
- [ ] 6.9" screenshots captured.
- [ ] App Privacy, age rating and review notes entered as above.
13 changes: 12 additions & 1 deletion docs/PRIVACY.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Pagemark — Privacy Policy

*Last updated 2026-10-14 · applies to Pagemark 0.13.2 and later*
*Last updated 2026-10-22 · applies to Pagemark 0.13.2 and later on Android, and to the iPhone version*

Pagemark is a private reading log. It has no accounts, no servers of its own, no advertising and no analytics. This page says exactly what the app stores and when anything leaves your phone.

Expand Down Expand Up @@ -44,6 +44,17 @@ Locked books stay in the same database but are hidden from the main library, Sta
## Permissions
Internet (lookup, updates, backup) · Camera (barcode scanner, only when you open it) · Biometric (fingerprint/device unlock) · Install packages (to install a downloaded update) · Notifications (a warning when scheduled backups keep failing) · Background work, network state, wake lock, foreground service and start-after-reboot (scheduled backups and reminders; they let the system run those jobs and re-schedule reminders after a restart) · Vibrate (notification vibration) · Fingerprint (older-Android fingerprint unlock). Pagemark does not ask for location, contacts, microphone, storage or accounts.


## On iPhone

The iPhone version follows the same rules, with these differences:
- Your PIN hash, recovery code and backup passphrase are kept in the iPhone Keychain instead of Android's secure storage.
- Face ID or Touch ID is handled by iOS; Pagemark only learns whether it succeeded.
- The barcode reader uses Apple's on-device Vision framework. Nothing from the camera is saved or sent, and no Google library is involved.
- There is no update check or download: the App Store updates the app. There are no folder backups and no home-screen widget yet; you save backups yourself with the Share sheet.
- While the locked library is open, Pagemark covers its screen when you switch apps, so the app switcher does not show your private books.
- Permissions asked for: camera (barcode scanner), Face ID, photos (only when you pick a cover picture) and notifications (reminders).

## Your control
- Export everything any time (Settings → Import and export), or back it up yourself.
- Delete everything by uninstalling the app. Backup files you saved yourself stay wherever you put them; delete them there.
Expand Down
105 changes: 105 additions & 0 deletions docs/privacy.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,105 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Pagemark Privacy Policy</title>
<style>
body { font-family: system-ui, -apple-system, "Segoe UI", sans-serif; max-width: 780px; margin: 2rem auto; padding: 0 1rem; line-height: 1.65; color: #222; background: #fff; }
h1 { font-size: 1.8rem; }
h2 { font-size: 1.25rem; margin-top: 2rem; border-bottom: 1px solid #ddd; padding-bottom: .2rem; }
table { border-collapse: collapse; width: 100%; margin: 1rem 0; }
th, td { border: 1px solid #ccc; padding: .5rem; text-align: left; vertical-align: top; font-size: .95rem; }
th { background: #f3f3f3; }
a { color: #0b5cad; }
</style>
</head>
<body>
<h1>Pagemark — Privacy Policy</h1>
<p><em>Last updated 2026-10-22 · applies to Pagemark 0.13.2 and later on Android, and to the iPhone version</em></p>
<p>Pagemark is a private reading log. It has no accounts, no servers of its own, no advertising and no analytics. This page says exactly what the app stores and when anything leaves your phone.</p>
<h2>Our promise</h2>
<ul>
<li><strong>We never collect your data.</strong> No account, no analytics, no tracking, no advertising ID, no crash-reporting service. There is no Pagemark server to send anything to.</li>
<li><strong>No ads, no selling, no sharing.</strong></li>
<li><strong>No AI inside the app.</strong> No assistant, no AI features, and nothing you write is sent to or used to train an AI service.</li>
<li><strong>Your books stay on your phone</strong> unless you save a backup, and then only where you put it.</li>
<li><strong>Free and open to inspect:</strong> the code is public.</li>
<li><strong>The only internet use:</strong> book searches (to Open Library and, unless turned off in Settings, Google Books), the GitHub build's update check, and whatever a cloud app does with a backup folder you choose.</li>
<li><strong>About the barcode reader:</strong> it uses Google's on-device ML Kit vision tool. Pagemark never saves or sends the camera picture, but the Google library may report anonymous technical information to Google.</li>
</ul>
<p>A test in the project fails if a tracking, advertising or AI package is added or the app contacts a new internet address.</p>
<h2>What Pagemark stores on your phone</h2>
<ul>
<li><strong>Your library:</strong> books, reads (dates, ratings, your thoughts), shelves, series, notes, tags and the Trash — in one database file inside the app's private storage.</li>
<li><strong>Settings:</strong> theme, library style, filters, backup options.</li>
<li><strong>Your PIN (if you set one)</strong> as a salted hash, and its recovery code as a hash, in Android's secure storage. The PIN itself is never stored.</li>
<li><strong>A backup passphrase (if you set one)</strong> in Android's secure storage, so scheduled backups can encrypt without you.</li>
<li><strong>Reminders and widget:</strong> the reminder is a notification scheduled on your phone and never names a book. The widget is drawn from the main library only (never the locked library) and shows counts only when the whole-app lock is on.</li>
<li><strong>Share target:</strong> text another app shares with Pagemark only fills the search box; it is never saved or sent anywhere until you pick a result, and then only the usual Open Library lookup happens.</li>
<li><strong>Folder backups:</strong> if you choose a folder for automatic backups, Pagemark writes its backup files only into that folder (Android gives it access to that one folder and nothing else). If the folder belongs to a cloud app such as Google Drive, that app uploads the files under its own rules.</li>
<li><strong>A small event log</strong> (Settings → Help and about → Problem report): error messages and backup run results. Database error details are removed before anything is written, so it does not keep book titles or your writing.</li>
<li><strong>Cached cover images.</strong> Covers of locked books use a separate cache that is erased when the locked library closes.</li>
</ul>
<p>Android's own cloud backup and device-transfer are switched off for this app, so Google does not receive this data through Android.</p>
<h2>When data leaves your phone</h2>
<table>
<thead>
<tr>
<th>What</th>
<th>Where it goes</th>
<th>When</th>
<th>What is sent</th>
</tr>
</thead>
<tbody>
<tr>
<td>Book search / ISBN lookup / covers</td>
<td>Open Library (openlibrary.org, Internet Archive) and Google Books (googleapis.com; can be turned off in Settings)</td>
<td>when you search, scan, or a cover is shown</td>
<td>the text you typed or the ISBN; your IP address is visible to them as for any website</td>
</tr>
<tr>
<td>Update check</td>
<td>GitHub (api.github.com)</td>
<td>at most once a day while the app is open, if you leave "Check automatically" on</td>
<td>a request for the public release list; nothing about you or your library</td>
</tr>
<tr>
<td>Update download</td>
<td>GitHub</td>
<td>when you tap Download &amp; install</td>
<td>a request for the APK file</td>
</tr>
</tbody>
</table>
<p>Pagemark does <strong>not</strong> send anything to its developer or to any analytics, advertising or crash-reporting service.</p>
<h2>Locked library</h2>
<p>Locked books stay in the same database but are hidden from the main library, Stats, Trash, search and CSV/JSON exports. They <strong>are</strong> included in whole-database exports and folder backups, which is why encrypting those with a passphrase is recommended. Searching for a book while in the locked library sends your search text to Open Library; add the book manually to avoid that.</p>
<h2>Permissions</h2>
<p>Internet (lookup, updates, backup) · Camera (barcode scanner, only when you open it) · Biometric (fingerprint/device unlock) · Install packages (to install a downloaded update) · Notifications (a warning when scheduled backups keep failing) · Background work, network state, wake lock, foreground service and start-after-reboot (scheduled backups and reminders; they let the system run those jobs and re-schedule reminders after a restart) · Vibrate (notification vibration) · Fingerprint (older-Android fingerprint unlock). Pagemark does not ask for location, contacts, microphone, storage or accounts.</p>
<h2>On iPhone</h2>
<p>The iPhone version follows the same rules, with these differences:</p>
<ul>
<li>Your PIN hash, recovery code and backup passphrase are kept in the iPhone Keychain instead of Android's secure storage.</li>
<li>Face ID or Touch ID is handled by iOS; Pagemark only learns whether it succeeded.</li>
<li>The barcode reader uses Apple's on-device Vision framework. Nothing from the camera is saved or sent, and no Google library is involved.</li>
<li>There is no update check or download: the App Store updates the app. There are no folder backups and no home-screen widget yet; you save backups yourself with the Share sheet.</li>
<li>While the locked library is open, Pagemark covers its screen when you switch apps, so the app switcher does not show your private books.</li>
<li>Permissions asked for: camera (barcode scanner), Face ID, photos (only when you pick a cover picture) and notifications (reminders).</li>
</ul>

<h2>Your control</h2>
<ul>
<li>Export everything any time (Settings → Import and export), or back it up yourself.</li>
<li>Delete everything by uninstalling the app. Backup files you saved yourself stay wherever you put them; delete them there.</li>
<li>Turn off automatic update checks and automatic backups in Settings.</li>
</ul>
<h2>Children</h2>
<p>Pagemark is a general-purpose tool and collects no personal information from anyone, including children.</p>
<h2>Changes</h2>
<p>If this policy changes, the new version ships with the app (Settings → Updates → Version history) and in the repository: https://github.com/AxialForge/Pagemark</p>
<h2>Contact</h2>
<p>Questions or concerns: open an issue at https://github.com/AxialForge/Pagemark/issues.</p>
</body>
</html>
Loading