1# dumb-browser Development Guidelines
2
3Auto-generated from all feature plans. Last updated: 2025-01-21
4
5## Active Technologies  
6- Go 1.25.1 + WebKit2GTK (native), Cobra, Viper, SQLite3 (003-webkit2gtk-migration)
7- CGO bindings for WebKit2GTK C API integration
8
9## Project Structure
10```
11pkg/
12└── webkit/       # WebKit2GTK Go bindings (extractable)
13
14src/
15├── models/       # Data models and entities
16├── services/     # Business logic services  
17├── cli/         # Command line interface
18└── lib/         # Shared libraries
19
20tests/
21├── contract/    # Contract tests for WebKit bindings
22├── integration/ # Integration tests with WebKit2GTK
23└── unit/        # Unit tests
24```
25
26## Commands
27```bash
28# Testing and linting
29make test
30make lint
31
32# Build application
33make build
34
35# Development
36make dev
37
38# Generate code (SQLC)
39make generate
40
41# Database operations
42sqlite3 ~/.config/dumber/browser.db
43```
44
45## Code Style
46Go 1.25.1: Follow standard Go conventions with gofmt
47- Use structured logging (slog)
48- Proper error handling (no panics)
49- SQLC for type-safe database queries  
50- CGO memory management with Go finalizers
51- Constitutional simplicity principles
52
53## Recent Changes
54- 003-webkit2gtk-migration: Migrating from Wails to native WebKit2GTK with custom CGO bindings
55- 002-browser-controls-ui: Added keyboard/mouse controls, zoom persistence, clipboard integration
56
57## WebKit2GTK Integration
58- Reference repository: /home/brice/dev/clone/webkit2gtk-reference
59- pkg/webkit: Reusable WebKit2GTK Go bindings
60- Direct GTK event handling for keyboard shortcuts
61- WebKitUserContentManager for script injection
62
63<!-- MANUAL ADDITIONS START -->
64<!-- MANUAL ADDITIONS END -->