James Magahern
8216d7c706
git-subtree-dir: gtk git-subtree-mainline:c710c6e053git-subtree-split:7d0dfb455a
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. |