CLAUDE.md

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview

This repository contains a macOS markdown viewer application built with SwiftUI. The app allows users to open markdown files and render them with HTML preview in individual windows.

## Development Commands

- Build: `xcodebuild -project MarkdownViewer.xcodeproj -scheme MarkdownViewer -configuration Debug`
- Clean: `xcodebuild clean -project MarkdownViewer.xcodeproj`
- Open in Xcode: `open MarkdownViewer.xcodeproj`

## Architecture & Structure

- **MarkdownViewerApp.swift**: Main app entry point with Settings scene and File menu integration
- **ContentView.swift**: Contains MarkdownDocumentView for displaying markdown content
- **MarkdownRenderer.swift**: NSViewRepresentable wrapper for WKWebView with markdown-to-HTML conversion
- **MarkdownViewer.entitlements**: App entitlements with sandbox disabled for WebView functionality

## Getting Started

1. Open the project: `open MarkdownViewer.xcodeproj`
2. Build and run the application in Xcode (⌘R)
3. Use File → Open Markdown File (⌘O) to open markdown files
4. Each file opens in its own window with rendered HTML preview

## TODO - Feature Ideas

*Add new feature ideas here that can be worked on in future development sessions*

### Markdown Viewer Enhancements
- [ ] Add syntax highlighting for code blocks
- [ ] Support for markdown tables
- [ ] Add print functionality
- [ ] Export to PDF feature
- [ ] Dark mode support
- [ ] Custom CSS themes
- [x] Live preview while editing
- [ ] Search within document
- [ ] Zoom in/out functionality
- [x] Recent files menu
- [x] Save functionality via File menu (Save/Save As with ⌘S/⌘⇧S shortcuts)
- [ ] Drag and drop file support
- [ ] Support for math equations (LaTeX)
- [ ] Image paste support
- [ ] Full-screen reading mode
- [ ] Support for markdown extensions (strikethrough, task lists, etc.)
- [ ] Auto-save functionality for edited files
- [ ] Split view with source and preview
- [ ] Outline/table of contents sidebar
- [ ] Word count and reading time estimation

### Technical Improvements
- [ ] Add unit tests for markdown parsing
- [ ] Implement proper error handling and user feedback
- [ ] Add app icon and proper branding
- [ ] Optimize performance for large markdown files
- [ ] Add preferences/settings window
- [ ] Implement proper document state management
Genesis 2025-06-20 09:06:01 -07:00			`# CLAUDE.md`

			`This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.`

			`## Project Overview`

Claude.md improvements 2025-06-20 10:14:52 -07:00			`This repository contains a macOS markdown viewer application built with SwiftUI. The app allows users to open markdown files and render them with HTML preview in individual windows.`
Genesis 2025-06-20 09:06:01 -07:00
			`## Development Commands`

Claude.md improvements 2025-06-20 10:14:52 -07:00			- Build: `xcodebuild -project MarkdownViewer.xcodeproj -scheme MarkdownViewer -configuration Debug`
			- Clean: `xcodebuild clean -project MarkdownViewer.xcodeproj`
			- Open in Xcode: `open MarkdownViewer.xcodeproj`
Genesis 2025-06-20 09:06:01 -07:00
			`## Architecture & Structure`

Claude.md improvements 2025-06-20 10:14:52 -07:00			`- MarkdownViewerApp.swift: Main app entry point with Settings scene and File menu integration`
			`- ContentView.swift: Contains MarkdownDocumentView for displaying markdown content`
			`- MarkdownRenderer.swift: NSViewRepresentable wrapper for WKWebView with markdown-to-HTML conversion`
			`- MarkdownViewer.entitlements: App entitlements with sandbox disabled for WebView functionality`
Genesis 2025-06-20 09:06:01 -07:00
			`## Getting Started`

Claude.md improvements 2025-06-20 10:14:52 -07:00			1. Open the project: `open MarkdownViewer.xcodeproj`
			`2. Build and run the application in Xcode (⌘R)`
			`3. Use File → Open Markdown File (⌘O) to open markdown files`
			`4. Each file opens in its own window with rendered HTML preview`

			`## TODO - Feature Ideas`

			`Add new feature ideas here that can be worked on in future development sessions`

			`### Markdown Viewer Enhancements`
			`- [ ] Add syntax highlighting for code blocks`
			`- [ ] Support for markdown tables`
			`- [ ] Add print functionality`
			`- [ ] Export to PDF feature`
			`- [ ] Dark mode support`
			`- [ ] Custom CSS themes`
Add live preview while editing feature Implemented split-view editor with real-time markdown preview: - Added Edit/Preview toggle button with toolbar - Created MarkdownEditor component using NSTextView for raw markdown editing - Implemented HSplitView with editor on left and live preview on right - Fixed NSTextView width constraints to prevent unwanted scaling - Added proper text container configuration for word wrapping - Text changes update preview in real-time via SwiftUI binding 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com> 2025-06-20 10:40:43 -07:00			`- [x] Live preview while editing`
Claude.md improvements 2025-06-20 10:14:52 -07:00			`- [ ] Search within document`
			`- [ ] Zoom in/out functionality`
Add recent files menu functionality Implemented comprehensive recent files tracking system: - Created RecentFilesManager singleton with UserDefaults persistence - Added Recent Files submenu to File menu with up to 10 recent files - Automatic file validation that removes deleted files from list - Smart file tracking that adds files when opened and moves to top - Clear Recent Files option for user control - User-friendly display showing filename and relative path - Error handling for missing files with user notification 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com> 2025-06-20 10:48:11 -07:00			`- [x] Recent files menu`
Move save functionality to File menu - Remove save button from application toolbar - Add Save (⌘S) and Save As (⌘⇧S) menu items to File menu - Implement notification-based communication between menu and document views - Add unsaved changes indicator in window titles - Support both saving existing files and creating new files 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com> 2025-06-20 11:03:18 -07:00			`- [x] Save functionality via File menu (Save/Save As with ⌘S/⌘⇧S shortcuts)`
Claude.md improvements 2025-06-20 10:14:52 -07:00			`- [ ] Drag and drop file support`
			`- [ ] Support for math equations (LaTeX)`
			`- [ ] Image paste support`
			`- [ ] Full-screen reading mode`
			`- [ ] Support for markdown extensions (strikethrough, task lists, etc.)`
			`- [ ] Auto-save functionality for edited files`
			`- [ ] Split view with source and preview`
			`- [ ] Outline/table of contents sidebar`
			`- [ ] Word count and reading time estimation`

			`### Technical Improvements`
			`- [ ] Add unit tests for markdown parsing`
			`- [ ] Implement proper error handling and user feedback`
			`- [ ] Add app icon and proper branding`
			`- [ ] Optimize performance for large markdown files`
			`- [ ] Add preferences/settings window`
			`- [ ] Implement proper document state management`