58 lines
2.3 KiB
Markdown
58 lines
2.3 KiB
Markdown
|
# CLAUDE.md
|
||
|
|
|
||
|
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
||
|
|
|
||
|
|
## Build Commands
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Setup build directory (first time)
|
||
|
|
meson setup builddir
|
||
|
|
|
||
|
|
# Build project
|
||
|
|
meson compile -C builddir
|
||
|
|
|
||
|
|
# Clean rebuild
|
||
|
|
rm -rf builddir && meson setup builddir && meson compile -C builddir
|
||
|
|
|
||
|
|
# Run the application
|
||
|
|
./builddir/src/kordophone
|
||
|
|
```
|
||
|
|
|
||
|
|
## Architecture Overview
|
||
|
|
|
||
|
|
Kordophone is a GTK4/Libadwaita messaging client written in Vala that acts as a frontend to a separate DBus daemon (`kordophonecd`). The application follows a clean separation of concerns:
|
||
|
|
|
||
|
|
### Core Architecture
|
||
|
|
- **DBus Client**: This GTK app connects to `net.buzzert.kordophonecd` daemon over DBus
|
||
|
|
- **Split UI**: Main window has conversation list sidebar + transcript view
|
||
|
|
- **Custom Rendering**: Transcript uses Gtk.DrawingArea with snapshot API for performance
|
||
|
|
- **Repository Pattern**: All data operations go through `Repository` singleton which proxies to DBus service
|
||
|
|
|
||
|
|
### Key Components
|
||
|
|
- **Application** (`src/application/`): App lifecycle, main window, preferences
|
||
|
|
- **Service** (`src/service/`): DBus integration, data repository, settings management
|
||
|
|
- **Conversation List** (`src/conversation-list/`): Sidebar with conversation list and search
|
||
|
|
- **Transcript** (`src/transcript/`): Message display with pluggable bubble layouts
|
||
|
|
- **Models** (`src/models/`): Data structures (Conversation, Message, Attachment)
|
||
|
|
|
||
|
|
### DBus Interface
|
||
|
|
The app depends on a running `kordophonecd` daemon that provides:
|
||
|
|
- **Repository interface**: Conversation/message CRUD, real-time sync via signals
|
||
|
|
- **Settings interface**: Server configuration, user credentials
|
||
|
|
|
||
|
|
### Development Notes
|
||
|
|
- Vala compiles to C, build artifacts in `builddir/`
|
||
|
|
- DBus interfaces auto-generated from XML: run `src/service/interface/generate.sh`
|
||
|
|
- Resources bundled via GResource (`src/resources/kordophone.gresource.xml`)
|
||
|
|
- Custom CSS styling in `src/resources/style.css`
|
||
|
|
- Application ID: `net.buzzert.kordophone2`
|
||
|
|
|
||
|
|
### Message Layout System
|
||
|
|
Transcript view uses a pluggable layout system in `src/transcript/layouts/`:
|
||
|
|
- `BubbleLayout`: Base class for message bubbles
|
||
|
|
- `TextBubbleLayout`: Text messages
|
||
|
|
- `ImageBubbleLayout`: Image attachments
|
||
|
|
- `DateItemLayout`: Date separators
|
||
|
|
- `SenderAnnotationLayout`: Sender labels
|
||
|
|
|
||
|
|
All layouts render to Cairo context via Gtk snapshot API for efficient scrolling performance.
|