feat: initial commit

README.md

@@ -0,0 +1,49 @@
+# Wayland Shot
+
+`Wayland Shot` is a KDE-first screenshot tool for Wayland sessions on Debian-based Linux.
+
+The first serious build targets:
+- fast launch from `Alt+Shift+F12`
+- `region` and `fullscreen` capture modes
+- a lightweight annotation editor with `select`, `arrow`, `line`, `rectangle`, and `text`
+- `copy`, `save`, and `save as`
+
+## Why Qt6/C++
+
+This machine already ships a full Qt6 runtime and KDE session stack. Qt6 is the shortest path to a native-feeling KDE application with strong D-Bus, clipboard, image editing, and packaging support.
+
+## Current State
+
+This repository currently contains:
+- the application skeleton
+- a working editor document model
+- an annotation canvas shell
+- export plumbing for clipboard and PNG save
+- a placeholder capture backend until the real KDE/portal capture backend lands
+
+## Planned Build Dependencies
+
+For the native build we expect these packages:
+- `qt6-base-dev`
+- `qt6-tools-dev`
+- `qt6-tools-dev-tools`
+- `qt6-wayland-dev`
+- `qt6-svg-dev`
+- `qt6-declarative-dev`
+- `libkf6globalaccel-dev` if we link KDE global shortcut support directly
+
+## Build
+
+```bash
+cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug
+cmake --build build
+ctest --test-dir build --output-on-failure
+```
+
+## v1 Boundary
+
+Deliberately cut from the first usable local build:
+- window capture
+- blur and pixelation tools
+- screenshot history/gallery
+- cross-desktop guarantees beyond KDE Wayland