markpdfdown-desktop: Instructions file for Claude Code

CLAUDE.md

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

Project Overview

MarkPDFdown Desktop is an Electron application that converts PDF/images to Markdown using LLM visual recognition. Built with Electron 38 + React 18 + TypeScript + Vite (via electron-vite) + Prisma (SQLite) + Ant Design 5.

Commands

# Development
npm run dev                # Generate Prisma client + start dev server

# Build
npm run build              # Generate Prisma client + production build
npm run build:win          # Build Windows NSIS installer
npm run build:mac          # Build macOS DMG
npm run build:linux        # Build Linux AppImage

# Testing (Vitest)
npm test                   # Run all tests (watch mode)
npm run test:unit          # Unit tests only (main process + core, node env)
npm run test:renderer      # Component tests only (React, jsdom env)
npm run test:watch         # Watch mode
npm run test:coverage      # Coverage report

# Single test file
npx vitest run path/to/file.test.ts --config vitest.config.ts        # unit test
npx vitest run path/to/file.test.tsx --config vitest.config.renderer.ts  # renderer test

# Database
npm run generate           # Generate Prisma client
npm run migrate:dev        # Run migrations (dev)

# Code quality
npm run lint               # ESLint with auto-fix
npm run typecheck          # TypeScript type checking

Architecture

Three-process Electron structure

• Main process (src/main/): Window management, IPC handler registration, app lifecycle
• Preload (src/preload/): Secure bridge exposing window.api to renderer
• Renderer (src/renderer/): React SPA with Ant Design, HashRouter routing

Core business logic (src/core/) — Clean Architecture

core/
├── domain/           # Interfaces only: ILLMClient, ISplitter, repositories
├── application/      # Business logic orchestration
│   ├── services/     # WorkerOrchestrator, ModelService, PresetProviderService
│   └── workers/      # WorkerBase (abstract), SplitterWorker, ConverterWorker, MergerWorker
├── infrastructure/   # External implementations
│   ├── db/           # Prisma schema, migrations, client
│   ├── adapters/
│   │   ├── llm/      # OpenAIClient, AnthropicClient, GeminiClient, OllamaClient, OpenAIResponsesClient
│   │   └── split/    # PDFSplitter, ImageSplitter, SplitterFactory
│   └── services/     # FileService
└── shared/events/    # EventBus for worker coordination