From a59da346bc2d5a58a69134dbf9962b4ceb62264b Mon Sep 17 00:00:00 2001
From: Brent Simmons <brent@ranchero.com>
Date: Mon, 4 Aug 2025 11:28:32 -0700
Subject: [PATCH] Add Claude support.

---
 .claude/settings.local.json |  8 +++++
 CLAUDE.md                   | 62 +++++++++++++++++++++++++++++++++++++
 2 files changed, 70 insertions(+)
 create mode 100644 .claude/settings.local.json
 create mode 100644 CLAUDE.md

diff --git a/.claude/settings.local.json b/.claude/settings.local.json
new file mode 100644
index 000000000..cfc635a58
--- /dev/null
+++ b/.claude/settings.local.json
@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(find:*)"
+    ],
+    "deny": []
+  }
+}
\ No newline at end of file
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 000000000..7be690084
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,62 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build and Development Commands
+
+### Building and Testing
+- **Full build and test**: `./buildscripts/build_and_test.sh` - Builds both macOS and iOS targets and runs all tests
+- **Quiet build and test**: `./buildscripts/quiet_build_and_test.sh` - Same as above with less verbose output
+- **Manual Xcode builds**:
+  - macOS: `xcodebuild -project NetNewsWire.xcodeproj -scheme NetNewsWire -destination "platform=macOS,arch=arm64" build`
+  - iOS: `xcodebuild -project NetNewsWire.xcodeproj -scheme NetNewsWire-iOS -destination "platform=iOS Simulator,name=iPhone 16" build`
+
+### Testing
+- Run all tests: Use the `NetNewsWire.xctestplan` which includes tests from all modules
+- Individual test runs follow same xcodebuild pattern with `test` action instead of `build`
+
+### Setup
+- First-time setup: Run `./setup.sh` to configure development environment and code signing
+- Manual setup: Create `SharedXcodeSettings/DeveloperSettings.xcconfig` in parent directory
+
+## Project Architecture
+
+### High-Level Structure
+NetNewsWire is a multi-platform RSS reader with separate targets for macOS and iOS, organized as a modular architecture with shared business logic.
+
+### Key Modules (in /Modules)
+- **RSCore**: Core utilities, extensions, and shared infrastructure
+- **RSParser**: Feed parsing (RSS, Atom, JSON Feed, RSS-in-JSON)
+- **RSWeb**: HTTP networking, downloading, caching, and web services
+- **RSDatabase**: SQLite database abstraction layer using FMDB
+- **Account**: Account management (Local, Feedbin, Feedly, NewsBlur, Reader API, CloudKit)
+- **Articles**: Article and author data models
+- **ArticlesDatabase**: Article storage and search functionality
+- **SyncDatabase**: Cross-device synchronization state management
+- **Secrets**: Secure credential and API key management
+
+### Platform-Specific Code
+- **Mac/**: macOS-specific UI (AppKit), preferences, main window management
+- **iOS/**: iOS-specific UI (UIKit), settings, navigation
+- **Shared/**: Cross-platform business logic, article rendering, smart feeds
+
+### Key Architectural Patterns
+- **Account System**: Pluggable account delegates for different sync services
+- **Feed Management**: Hierarchical folder/feed organization with OPML import/export
+- **Article Rendering**: Template-based HTML rendering with custom CSS themes
+- **Smart Feeds**: Virtual feeds (Today, All Unread, Starred) implemented as PseudoFeed protocol
+- **Timeline/Detail**: Classic three-pane interface (sidebar, timeline, detail)
+
+### Extension Points
+- Share extensions for both platforms
+- Safari extension for feed subscription
+- Widget support for iOS
+- AppleScript support on macOS
+- Intent extensions for Siri shortcuts
+
+### Development Notes
+- Uses Xcode project with Swift Package Manager for module dependencies
+- Requires `xcbeautify` for formatted build output in scripts
+- API keys are managed through buildscripts/updateSecrets.sh (runs during builds)
+- Some features disabled in development builds due to private API keys
+- Code signing configured through SharedXcodeSettings for development
\ No newline at end of file