Add comprehensive iOS app build specification and implementation guide

[shellen]

Summary

This PR adds a complete, production-ready build specification for the PullRead iOS app, including detailed architecture documentation, full source code templates, and implementation guidance for developers.

Changes

• New file: docs/plans/seed-ios-app.md — A 807-line comprehensive build specification containing:

  • Complete project architecture with WebView + native Swift module integration
  • Full source code for all React Native/Expo components (_layout.tsx, index.tsx, reader.tsx)
  • Fetch bridge implementation for intercepting /api/* calls from the embedded viewer
  • API handler routing logic for file operations
  • Complete Swift native module (FolderAccessModule.swift) for:
    • iOS document picker integration
    • Security-scoped bookmark persistence
    • Markdown file enumeration with frontmatter parsing
    • File read/write operations
  • On-device sync engine architecture (feed parsing, article extraction, markdown generation)
  • Authenticated fetching strategy using WKWebView in-app login
  • Viewer HTML preparation instructions
  • Frontmatter format specification
  • File access patterns for cloud storage integration (iCloud, Dropbox, etc.)
  • Comprehensive gotchas and verification checklist

• Updated: docs/plans/2026-02-20-ios-next-steps.md — Minor clarifications to next steps document

Key Implementation Details

• Architecture: WebView-based reader with fetch interception bridge routing API calls to a native Swift module for file system access
• File Access: Uses iOS security-scoped bookmarks to persist access to user-selected folders across app restarts
• Frontmatter Parsing: Extracts metadata from markdown files (title, URL, domain, author, etc.) for article listings
• Sync Engine: Ports desktop extraction pipeline (fast-xml-parser, Readability, Turndown) to React Native with AsyncStorage for URL deduplication
• Authentication: WKWebView-based in-app login for paywalled sites, storing cookies for authenticated fetch requests
• Cloud Integration: Works with any iOS File Provider (iCloud Drive, Dropbox, Google Drive, OneDrive)

This specification is designed to be dropped into an LLM session with "build this" and contains everything needed to create the app from scratch.

https://claude.ai/code/session_01WMT1AFxqumho5N9KTPdhnq