refactor: flatten to single crate and make docs timeless

Move bitvault-app to repo root. Remove workspace, single crate at root.
Update CI cache paths, Dockerfile, Makefile, README, .gitignore.

Docs: remove temporal status notes, Future/Roadmap, dates. Replace Phase
with Step. Fix broken links. Delete redundant/speculative docs:
SIMPLE_TWO_INSTANCE_TEST, MULTISIG_TESTING_SUMMARY, ssh-guide,
DUPLICATION_ANALYSIS, core-api, CODE_REUSE_STRATEGY, platform-security,
ARCHITECTURE_PLAN, IMPLEMENTATION_READY, implementation-plan,
UI_MODERNIZATION_PLAN. Update arch-linux-setup, architecture-overview,
index, ai-context, CONTRIBUTING.

Made-with: Cursor

Author: secsovereign

.github/workflows/ci.yml

@@ -54,17 +54,13 @@ jobs:
             ${{ runner.os }}-cargo-
       
       - name: Build
-        working-directory: bitvault-app
         run: cargo build --release
 
       - name: Run tests
-        working-directory: bitvault-app
         run: cargo test --release
 
       - name: Clippy
-        working-directory: bitvault-app
         run: cargo clippy --all-targets -- -D warnings
 
       - name: Format check
-        working-directory: bitvault-app
         run: cargo fmt --all -- --check

.github/workflows/nightly.yml

@@ -51,20 +51,17 @@ jobs:
             ${{ runner.os }}-cargo-nightly-
       
       - name: Build
-        working-directory: bitvault-app
         run: cargo build --release
 
       - name: Package binary
         shell: bash
-        working-directory: bitvault-app
         run: |
-          # Platform-specific packaging
           if [ "${{ runner.os }}" == "Linux" ]; then
-            tar czf ../../bitvault-desktop-nightly-linux-x86_64-$(date +%Y-%m-%d).tar.gz target/release/bitvault-app
+            tar czf bitvault-desktop-nightly-linux-x86_64-$(date +%Y-%m-%d).tar.gz target/release/bitvault-app
           elif [ "${{ runner.os }}" == "macOS" ]; then
-            tar czf ../../bitvault-desktop-nightly-macos-$(date +%Y-%m-%d).tar.gz target/release/bitvault-app
+            tar czf bitvault-desktop-nightly-macos-$(date +%Y-%m-%d).tar.gz target/release/bitvault-app
           elif [ "${{ runner.os }}" == "Windows" ]; then
-            powershell Compress-Archive -Path target/release/bitvault-app.exe -DestinationPath ../../bitvault-desktop-nightly-windows-x86_64-$(date +%Y-%m-%d).zip
+            powershell Compress-Archive -Path target/release/bitvault-app.exe -DestinationPath bitvault-desktop-nightly-windows-x86_64-$(date +%Y-%m-%d).zip
           fi
       
       - name: Generate checksum

.github/workflows/release.yml

@@ -54,24 +54,21 @@ jobs:
           key: ${{ runner.os }}-cargo-release-${{ hashFiles('Cargo.lock') }}
 
       - name: Build
-        working-directory: bitvault-app
         run: cargo build --release
 
       - name: Run tests
-        working-directory: bitvault-app
         run: cargo test --release
 
       - name: Package release
         shell: bash
-        working-directory: bitvault-app
         run: |
           VERSION=${GITHUB_REF#refs/tags/v}
           if [ "${{ runner.os }}" == "Linux" ]; then
-            tar czf ../../bitvault-desktop-${VERSION}-linux-x86_64.tar.gz target/release/bitvault-app
+            tar czf bitvault-desktop-${VERSION}-linux-x86_64.tar.gz target/release/bitvault-app
           elif [ "${{ runner.os }}" == "macOS" ]; then
-            tar czf ../../bitvault-desktop-${VERSION}-macos.tar.gz target/release/bitvault-app
+            tar czf bitvault-desktop-${VERSION}-macos.tar.gz target/release/bitvault-app
           elif [ "${{ runner.os }}" == "Windows" ]; then
-            powershell Compress-Archive -Path target/release/bitvault-app.exe -DestinationPath ../../bitvault-desktop-${VERSION}-windows-x86_64.zip
+            powershell Compress-Archive -Path target/release/bitvault-app.exe -DestinationPath bitvault-desktop-${VERSION}-windows-x86_64.zip
           fi
       
       - name: Generate checksum

.gitignore

@@ -8,7 +8,7 @@
 .cargo/
 
 # Cargo
-# Note: Cargo.lock should be committed for applications (bitvault-app)
+# Note: Cargo.lock should be committed for applications
 # but not for libraries. We keep it for the app.
 # **/Cargo.lock
 

CONTRIBUTING.md

@@ -27,12 +27,9 @@ For security issues, please follow the responsible disclosure process outlined i
 
 ### Project Structure
 
-BitVault is a Rust workspace project with the following crates:
-- `bitvault-app` - Main application crate that ties everything together
-- `bitvault-core` - Core wallet functionality and cryptographic operations
-- `bitvault-common` - Shared utilities and types
-- `bitvault-ipc` - Inter-process communication between components
-- `bitvault-app` - User interface components (egui/eframe)
+BitVault Desktop is a Rust application (single crate at repo root):
+- `src/` - Application source, UI (egui/eframe), services, state
+- `bitvault-common` - Shared utilities and types (external dependency)
 
 ### Prerequisites
 
@@ -44,8 +41,8 @@ BitVault is a Rust workspace project with the following crates:
 
 1. Fork the repository
 2. Clone your fork locally
-3. Install dependencies with `make setup`
-4. Start the development server with `make dev`
+3. Install dependencies (Rust, egui deps — see [arch-linux-setup.md](docs/setup/arch-linux-setup.md) for platform-specific steps)
+4. Build and run with `cargo run` or `make dev`
 
 ## Development Workflow
 

Cargo.toml

@@ -1,38 +1,91 @@
-[workspace]
-resolver = "2"
-default-members = ["bitvault-app"]
-members = [
-    "bitvault-app",    # Main egui application
-]
-
-# Workspace-wide settings (shared by all members)
-[workspace.package]
+[package]
+name = "bitvault-app"
 version = "0.1.0"
 edition = "2021"
 authors = ["BitVault Team"]
 repository = "https://github.com/BitVaulty/bitvault-desktop"
 
-# Shared dependencies across workspace members
-[workspace.dependencies]
-# Common dependencies
+[lib]
+name = "bitvault_app"
+path = "src/lib.rs"
+
+[features]
+default = ["native"]
+# Native: desktop/mobile with SQLite, HTTP, file system (used by app_state cfg)
+native = []
+
+[dependencies]
+# GUI
+eframe = "0.27"
+egui = "0.27"
+egui_extras = { version = "0.27", features = ["svg"] }
+
+# SVG icon rendering
+resvg = "0.37"
+usvg = "0.37"
+tiny-skia = "0.11"
+lazy_static = "1.4"
+
+# Bitcoin - Use directly, no wrappers
+bdk = { version = "0.30", features = ["keys-bip39", "sqlite"] }
+bitcoin = "0.32"
+secp256k1 = "0.28"
+bip39 = "2.0"
+rand = "0.8"
+
+# Shared library dependency
+# CI uses git, local dev uses path override via .cargo/config.toml
+bitvault-common = { git = "https://github.com/BitVaulty/bitvault-common.git", branch = "dev", features = ["keyring-storage"] }
+
+# UR/QR
+ur = "0.4.1"
+qrcode = "0.14"
+quircs = "0.10"
+ciborium = "0.2"
+image = "0.25"
+rfd = "0.14"  # File dialogs for image selection
+nokhwa = { version = "0.10", features = ["input-native"] }  # Camera capture
+
+# Infrastructure
+reqwest = { version = "0.12", features = ["json"] }
+tokio = { version = "1", features = ["full"] }
+rusqlite = { version = "0.31", features = ["bundled"] }
+keyring = "2.0"
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 anyhow = "1.0.86"
+thiserror = "1.0"
+base64 = "0.22"
+tracing = "0.1"
+tracing-subscriber = "0.3"
+notify-rust = "4.11"
+chrono = { version = "0.4", features = ["serde"] }
+bs58 = "0.5"
+
+# Logging
+simple_logger = "5.0"
 log = "0.4"
 
-# Security-related dependencies
-zeroize = "1.7.0"
-getrandom = "0.3.2"
-aes-gcm = "0.10.3"
-rand = "0.9.0"
-rand_core = "0.9.3"
-argon2 = "0.5.2"
-hex = "0.4.3"
-
-# Bitcoin dependencies (for reference, used in bitvault-app)
-bdk = "0.30"
-bitcoin = "0.32"
-secp256k1 = "0.28"
+# File system
+dirs = "5.0.1"
+toml = "0.8"
 
-# Error handling
-thiserror = "1.0"
+# Platform-specific dependencies
+[target.'cfg(target_os = "windows")'.dependencies]
+windows = { version = "0.52", features = [
+    "Security_Credentials_UI",
+    "Foundation",
+    "Win32_Graphics_Gdi",
+    "Win32_UI_WindowsAndMessaging",
+] }
+
+# macOS dependencies for biometric authentication
+[target.'cfg(target_os = "macos")'.dependencies]
+objc2 = "0.5"
+objc2-foundation = "0.2"
+
+[dev-dependencies]
+# Testing
+tempfile = "3.10"
+tokio-test = "0.4"
+mockito = "1.2"

Dockerfile

@@ -27,7 +27,7 @@ WORKDIR /app
 COPY . .
 
 RUN cargo test
-RUN cargo build --release -p bitvault-app
+RUN cargo build --release
 
 # Stage 2: Runtime stage (as before)
 FROM debian:bullseye-slim

Makefile

@@ -1,34 +1,23 @@
-.PHONY: dev build release test core-test ui-test security-test clean lint check all wasm docs
+.PHONY: dev build release test clean lint check security-check all docs
 
 # Primary development targets
 dev:
-	cargo run -p bitvault-app
+	cargo run
 
 build:
-	cargo build --workspace
+	cargo build
 
 release:
-	cargo build --workspace --release
+	cargo build --release
 
 # Test targets
 test:
-	cargo test --workspace
-
-core-test:
-	cargo test -p bitvault-common
-
-ui-test:
-	cargo test -p bitvault-app
-
-security-test:
-	cargo test -p bitvault-core --features security_tests
-	./scripts/test-security-boundary.sh
+	cargo test
 
 # Security validation
 security-check:
 	cargo audit
-	cargo clippy --workspace -- -D warnings
-	./scripts/check-security-boundaries.sh
+	cargo clippy -- -D warnings
 
 # Cleanup
 clean:
@@ -37,31 +26,30 @@ clean:
 
 # Code quality
 lint:
-	cargo clippy --workspace -- -D warnings
+	cargo clippy -- -D warnings
 	cargo fmt --all -- --check
 
 check: lint security-check test
 
-# Build wasm version (for future web interface)
+# Build wasm version (optional)
 # wasm:
-# 	cd bitvault-app && trunk build
-# Note: egui/eframe doesn't use trunk, this is for future web support
+# 	trunk build
 
 # Run in development mode with security boundary logging
 dev-debug:
-	BITVAULT_LOG=debug cargo run -p bitvault-app
+	BITVAULT_LOG=debug cargo run
 
 # Run with process isolation verification
 dev-secure:
-	BITVAULT_VERIFY_ISOLATION=1 cargo run -p bitvault-app
+	BITVAULT_VERIFY_ISOLATION=1 cargo run
 
 # Generate documentation
 docs:
-	cargo doc --workspace --no-deps
-	@echo "Documentation available at target/doc/bitvault_common/index.html"
+	cargo doc --no-deps
+	@echo "Documentation available at target/doc/bitvault_app/index.html"
 
 # Build all variants
-all: clean build release wasm
+all: clean build release
 
 # Default target
 .DEFAULT_GOAL := build

README.md

@@ -1,56 +1,47 @@
 # BitVault Desktop
 
-Bitcoin wallet desktop application built with Rust + egui.
+Bitcoin multisig wallet desktop application built with Rust + egui.
 
 ## Architecture
 
-- **UI**: egui (immediate mode GUI)
+- **UI**: egui/eframe (immediate mode GUI)
 - **Bitcoin**: BDK (used directly, no wrappers)
-- **Structure**: Clean separation between app logic and Bitcoin operations
+- **Shared logic**: bitvault-common (separate repo, git dependency)
 
 ## Quick Start
 
 ```bash
 # Build and run
-cargo run --bin bitvault-app
+cargo run
 
 # Check compilation
-cargo check --workspace
+cargo check
 
 # Run tests
-cargo test --workspace
+cargo test
 ```
 
 ## Project Structure
 
 ```
 bitvault-desktop/
-├── bitvault-app/      # Main egui application
-│   ├── src/
-│   │   ├── app.rs     # Main app struct
-│   │   ├── ui/        # UI screens
-│   │   ├── services/  # Service layer (uses BDK directly)
-│   │   ├── models/    # Data models
-│   │   ├── state/     # App state management
-│   │   └── utils/     # Utilities (UR/QR, etc.)
-│   └── Cargo.toml
-│
-└── bitvault-common/   # App-specific shared code
-    ├── src/
-    │   ├── config.rs  # Configuration
-    │   ├── events.rs  # Event system
-    │   ├── error.rs   # Error types
-    │   └── ...
-    └── Cargo.toml
+├── Cargo.toml
+├── src/               # Application source
+│   ├── app.rs         # Main app struct
+│   ├── ui/            # UI screens
+│   ├── services/      # Service layer
+│   ├── state/         # App state management
+│   └── utils/         # UR/QR, etc.
+├── tests/
+├── resources/
+└── docs/
 ```
 
-## Key Principles
-
-1. **Use BDK directly** - No wrappers around BDK
-2. **App-specific code in common** - Only non-Bitcoin logic
-3. **Clean architecture** - Clear separation of concerns
-4. **Mirror mobile structure** - Match Swift app organization
+**bitvault-common** is an external dependency (https://github.com/BitVaulty/bitvault-common). For local development, use a path override in `.cargo/config.toml` (gitignored).
 
 ## Development
 
-See `ARCHITECTURE_PLAN.md` for detailed architecture documentation.
+- **Arch Linux**: [docs/setup/arch-linux-setup.md](docs/setup/arch-linux-setup.md)
+- **Architecture**: [docs/design/architecture-overview.md](docs/design/architecture-overview.md)
+- **Makefile**: `make dev`, `make test`, `make lint`
+