Project Structure

yap/
├── app.go                 # Main application logic
├── main.go                # Wails entry point
├── internal/              # Go packages
├── frontend/              # React application
└── build/                 # Build assets and output

type Engine interface {
    Transcribe(audioPath string) (string, error)
}

frontend/
├── src/
│   ├── App.tsx            # Main UI component
│   ├── App.css            # Styles
│   ├── RecordingOverlay.tsx  # Web fallback overlay
│   ├── main.tsx           # React entry
│   └── wailsjs/           # Generated Wails bindings
├── package.json
├── tsconfig.json
└── vite.config.ts

import { ToggleRecording, GetState } from '../wailsjs/go/main/App';

// Call Go methods from React
await ToggleRecording();
const state = await GetState();

build/
├── appicon.png            # Application icon (PNG)
├── appicon.icns          # macOS icon
├── darwin/               # macOS-specific
│   └── Info.plist        # App metadata
├── windows/              # Windows-specific
│   ├── icon.ico
│   └── installer/        # NSIS installer config
└── bin/                  # Build output

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│   Hotkey    │────▶│   app.go     │────▶│   Audio     │
│  Detection  │     │  (Wails)     │     │  Recording  │
└─────────────┘     └──────┬───────┘     └──────┬──────┘
                           │                     │
                           ▼                     ▼
                    ┌──────────────┐     ┌─────────────┐
                    │   Frontend   │     │ Transcribe  │
                    │   (React)    │◀────│   Engine    │
                    └──────────────┘     └─────────────┘
                           │
                           ▼
                    ┌──────────────┐
                    │  Clipboard   │
                    │  + Paste     │
                    └──────────────┘