@@ -1,70 +1,127 @@
+<div align="center">
+
 # Snowflake
 
-A modern AI-powered code editor built with **Tauri 2** (Rust) and **React 19** (TypeScript). Features conversational AI, code editing, terminal, Git integration, and file watching.
+**A modern AI-powered code editor built with Tauri 2 and React 19**
+
+[![CI](https://github.com/Recusive/Snowflake-V0/actions/workflows/ci.yml/badge.svg)](https://github.com/Recusive/Snowflake-V0/actions/workflows/ci.yml)
+[![Tauri Build](https://github.com/Recusive/Snowflake-V0/actions/workflows/tauri-build.yml/badge.svg)](https://github.com/Recusive/Snowflake-V0/actions/workflows/tauri-build.yml)
+![Tauri](https://img.shields.io/badge/Tauri-2.0-24C8D8?logo=tauri&logoColor=white)
+![React](https://img.shields.io/badge/React-19-61DAFB?logo=react&logoColor=black)
+![Rust](https://img.shields.io/badge/Rust-1.85-DEA584?logo=rust&logoColor=black)
+![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6?logo=typescript&logoColor=white)
+
+[Features](#features) • [Quick Start](#quick-start) • [Architecture](#architecture) • [Contributing](#contributing)
 
-![Tauri](https://img.shields.io/badge/Tauri-2.0-blue?logo=tauri)
-![React](https://img.shields.io/badge/React-19-blue?logo=react)
-![Rust](https://img.shields.io/badge/Rust-1.85-orange?logo=rust)
-![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue?logo=typescript)
-![License](https://img.shields.io/badge/License-Private-red)
+</div>
 
 ---
 
 ## Features
 
-- **AI Chat Interface** - Streaming responses with Claude AI, markdown rendering, code highlighting
-- **Code Editor** - CodeMirror 6 with syntax highlighting for 10+ languages
-- **Integrated Terminal** - Full terminal emulation with xterm.js and PTY support
-- **File Explorer** - Tree navigation with file watching and auto-refresh
-- **Git Integration** - Stage, commit, diff, branch, and log operations
-- **Tool Visualization** - Real-time display of AI tool execution
-- **Multi-Panel Layout** - Resizable panels for chat, files, editor, and terminal
-- **Cross-Platform** - macOS, Windows, and Linux support
+| Feature                | Description                                                                 |
+| ---------------------- | --------------------------------------------------------------------------- |
+| **AI Chat**            | Streaming responses with Claude AI, markdown rendering, syntax highlighting |
+| **Code Editor**        | CodeMirror 6 with 10+ language support and custom themes                    |
+| **Terminal**           | Full PTY terminal with xterm.js                                             |
+| **File Explorer**      | Tree navigation with real-time file watching                                |
+| **Git Integration**    | Stage, commit, diff, branch, log operations                                 |
+| **Tool Visualization** | Watch AI execute tools in real-time                                         |
+| **Multi-Panel Layout** | Resizable IDE-style panels                                                  |
+| **Cross-Platform**     | macOS, Windows, Linux                                                       |
 
 ---
 
 ## Quick Start
 
 ```bash
-# Install dependencies
+# Prerequisites: Node.js 22+, pnpm 9+, Rust 1.85+
+
+# Clone and install
+git clone https://github.com/Recusive/Snowflake-V0.git
+cd Snowflake-V0
 pnpm install
 
-# Start development (frontend + backend)
-pnpm tauri dev
+# Run the app (opens desktop window with hot-reload)
+pnpm dev
 ```
 
-This opens the desktop app with hot-reload for both React and Rust.
+> **Note:** First build compiles Rust and may take a few minutes. Subsequent starts are fast.
+
+---
+
+## Keyboard Shortcuts
+
+| Shortcut               | Action          |
+| ---------------------- | --------------- |
+| `Cmd/Ctrl + S`         | Save file       |
+| `Cmd/Ctrl + P`         | Quick open file |
+| `Cmd/Ctrl + Shift + P` | Command palette |
+| `Cmd/Ctrl + B`         | Toggle sidebar  |
+| `Cmd/Ctrl + J`         | Toggle terminal |
+| `Cmd/Ctrl + \``        | New terminal    |
+| `Cmd/Ctrl + N`         | New chat        |
+| `Cmd/Ctrl + Enter`     | Send message    |
 
 ---
 
 ## Technology Stack
 
+<table>
+<tr>
+<td valign="top" width="50%">
+
 ### Frontend
 
-| Technology          | Purpose                    |
-| ------------------- | -------------------------- |
-| **React 19**        | UI framework               |
-| **TypeScript 5.9**  | Type safety                |
-| **Vite 7**          | Build tool and dev server  |
-| **Tailwind CSS v4** | Styling (CSS-first config) |
-| **Zustand + Immer** | State management           |
-| **CodeMirror 6**    | Code editing               |
-| **xterm.js**        | Terminal emulation         |
-| **Shiki**           | Syntax highlighting        |
-| **Radix UI**        | Accessible components      |
-| **Zod 4**           | Runtime validation         |
+- **React 19** + TypeScript 5.9
+- **Vite 7** for builds
+- **Tailwind CSS v4**
+- **Zustand + Immer** state
+- **CodeMirror 6** editor
+- **xterm.js** terminal
+- **Shiki** highlighting
+- **Radix UI** components
+
+</td>
+<td valign="top" width="50%">
 
 ### Backend (Rust)
 
-| Crate            | Purpose                  |
-| ---------------- | ------------------------ |
-| **tauri 2**      | Desktop framework        |
-| **tokio**        | Async runtime            |
-| **git2**         | Git operations           |
-| **notify**       | File watching            |
-| **portable-pty** | Terminal PTY             |
-| **tower-lsp**    | Language Server Protocol |
-| **serde**        | JSON serialization       |
+- **Tauri 2** framework
+- **Tokio** async runtime
+- **git2** for Git ops
+- **notify** file watcher
+- **portable-pty** terminal
+- **tower-lsp** LSP support
+- **serde** serialization
+
+</td>
+</tr>
+</table>
+
+---
+
+## Architecture
+
+```
+┌────────────────────────────────────────────────────────────┐
+│                    Snowflake Desktop App                    │
+├────────────────────────────────────────────────────────────┤
+│  ┌──────────────────────────────────────────────────────┐  │
+│  │  Rust Backend (Main Process)                          │  │
+│  │  • Claude AI streaming    • File system + watching    │  │
+│  │  • Git operations         • Terminal PTY              │  │
+│  │  • Settings persistence   • Search (ripgrep)          │  │
+│  └─────────────────────────┬────────────────────────────┘  │
+│                            │ Tauri IPC                      │
+│  ┌─────────────────────────▼────────────────────────────┐  │
+│  │  React Frontend (Renderer)                            │  │
+│  │  • Chat interface         • CodeMirror editor         │  │
+│  │  • File explorer          • xterm terminal            │  │
+│  │  • Tool visualization     • Zustand state             │  │
+│  └──────────────────────────────────────────────────────┘  │
+└────────────────────────────────────────────────────────────┘
+```
 
 ---
 
@@ -73,160 +130,106 @@ This opens the desktop app with hot-reload for both React and Rust.
 ```
 Snowflake-v0/
 ├── src/                      # React frontend
-│   ├── components/           # UI components (90+ files)
-│   │   ├── chat/             # Chat interface
-│   │   ├── editor/           # CodeMirror integration
-│   │   ├── terminal/         # xterm.js terminal
-│   │   ├── activity/         # File viewer, diffs
-│   │   └── ui/               # Radix primitives
-│   ├── hooks/                # React hooks
+│   ├── components/           # 90+ UI components
+│   ├── hooks/                # Custom React hooks
 │   ├── stores/               # Zustand state (10 stores)
 │   └── types/                # TypeScript definitions
 │
-├── src-tauri/                # Tauri backend
-│   ├── src/
-│   │   ├── commands/         # Tauri command handlers
-│   │   │   ├── files.rs      # File operations
-│   │   │   ├── git.rs        # Git operations
-│   │   │   ├── terminal.rs   # Terminal/PTY
-│   │   │   └── settings.rs   # Configuration
-│   │   └── lib.rs            # App setup
-│   └── tauri.conf.json       # App config
+├── src-tauri/                # Tauri app
+│   └── src/commands/         # IPC command handlers
 │
-├── crates/                   # Rust library crates
-│   ├── snowflake-core/       # Core types
-│   ├── snowflake-fs/         # File system + watching
-│   ├── snowflake-git/        # Git operations
-│   ├── snowflake-terminal/   # PTY management
-│   ├── snowflake-settings/   # Configuration
-│   └── snowflake-search/     # Ripgrep search
-│
-└── Cargo.toml                # Rust workspace
+└── crates/                   # Rust libraries
+    ├── snowflake-core/       # Core types & text editing
+    ├── snowflake-fs/         # File system + watching
+    ├── snowflake-git/        # Git operations
+    ├── snowflake-terminal/   # PTY management
+    ├── snowflake-settings/   # Config persistence
+    └── snowflake-search/     # Ripgrep integration
 ```
 
 ---
 
 ## Development
 
-### Prerequisites
-
-- **Node.js** v22+ (see `.nvmrc`)
-- **pnpm** v9+
-- **Rust** 1.85+ with Cargo
-- **Tauri CLI**: `cargo install tauri-cli`
-
 ### Commands
 
-```bash
-# Development
-pnpm tauri dev           # Full app (Vite + Tauri + Rust)
-pnpm dev                 # Frontend only (port 5176)
-
-# Quality checks
-pnpm typecheck           # TypeScript check
-pnpm lint                # ESLint (zero warnings)
-pnpm check               # All checks (TS + ESLint + Rust)
-
-# Build
-pnpm tauri build         # Production app (.dmg/.exe/.AppImage)
-pnpm build               # Frontend production build
-```
+| Command           | Description               |
+| ----------------- | ------------------------- |
+| `pnpm dev`        | Start app with hot-reload |
+| `pnpm dev:web`    | Frontend only (port 5176) |
+| `pnpm build`      | Production build          |
+| `pnpm check`      | TypeScript + ESLint       |
+| `pnpm check:rust` | Rust fmt + clippy + test  |
+| `pnpm check:all`  | All quality checks        |
 
 ### Hot Reload
 
-| Change Type             | Behavior                    |
-| ----------------------- | --------------------------- |
-| React/TypeScript        | Instant HMR via Vite        |
-| CSS/Tailwind            | Instant HMR via Vite        |
-| Rust (`src-tauri/`)     | Auto-rebuilds, restarts app |
-| Rust crates (`crates/`) | Auto-rebuilds, restarts app |
-
----
-
-## Architecture
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                        Tauri Desktop App                         │
-│  ┌──────────────────────────────────────────────────────────┐   │
-│  │  Main Process (Rust)                                      │   │
-│  │  - Claude AI integration                                  │   │
-│  │  - File system operations                                 │   │
-│  │  - Git operations (git2)                                  │   │
-│  │  - Terminal PTY management                                │   │
-│  │  - File watching (notify)                                 │   │
-│  └────────────────────────┬─────────────────────────────────┘   │
-│                           │ IPC (invoke/events)                  │
-│  ┌────────────────────────▼─────────────────────────────────┐   │
-│  │  Renderer Process (React)                                 │   │
-│  │  - Chat interface                                         │   │
-│  │  - CodeMirror editor                                      │   │
-│  │  - xterm.js terminal                                      │   │
-│  │  - File explorer                                          │   │
-│  │  - Zustand state management                               │   │
-│  └──────────────────────────────────────────────────────────┘   │
-└─────────────────────────────────────────────────────────────────┘
-```
+| Change           | Behavior               |
+| ---------------- | ---------------------- |
+| React/TypeScript | Instant HMR            |
+| CSS/Tailwind     | Instant HMR            |
+| Rust code        | Auto-rebuild + restart |
 
 ---
 
 ## Code Quality
 
-### Rust
-
-- **Zero unsafe code**: `#![forbid(unsafe_code)]`
-- **No panics**: `#![deny(clippy::unwrap_used, clippy::expect_used)]`
-- **Strict linting**: All clippy::pedantic rules enabled
-- **cargo-deny**: License and vulnerability auditing
-
-### TypeScript
+### Enforced Standards
 
-- **Maximum strictness**: All strict options enabled
-- **No implicit any**: Every type explicit
-- **ESLint**: Zero warnings tolerance
-- **Consistent imports**: Type imports separated
+| Area           | Rules                                   |
+| -------------- | --------------------------------------- |
+| **Rust**       | Zero unsafe, no panics, clippy pedantic |
+| **TypeScript** | Maximum strictness, no `any`            |
+| **ESLint**     | Zero warnings tolerance                 |
+| **Pre-commit** | Husky + lint-staged                     |
+| **CI**         | 11 parallel checks on every push        |
 
-### CI/CD
+### CI Pipeline
 
-- GitHub Actions for all quality checks
-- Pre-commit hooks with Husky + lint-staged
-- Dependabot auto-merge for patches
-- Release automation on version tags
+```
+Frontend:  TypeScript → ESLint → Build
+Backend:   Format → Clippy → Test → Deny → Doc → MSRV
+           ↓
+        CI Passed (quality gate)
+```
 
 ---
 
 ## Implementation Status
 
-### Completed
+### Done
 
-- [x] Tauri 2 desktop framework
-- [x] React 19 frontend with TypeScript
-- [x] CodeMirror 6 editor with themes
-- [x] File system operations with watching
-- [x] Git integration (stage, commit, diff, log)
-- [x] Settings management with persistence
-- [x] Multi-panel resizable layout
-- [x] Theme switching (light/dark)
+- [x] Tauri 2 + React 19 setup
+- [x] CodeMirror editor with themes
+- [x] File system with watching
+- [x] Git integration (full)
+- [x] Settings persistence
+- [x] Multi-panel layout
+- [x] Light/dark themes
 
 ### In Progress
 
-- [ ] Claude AI streaming integration
-- [ ] LSP language server support
-- [ ] Terminal PTY full implementation
+- [ ] Claude AI streaming
+- [ ] LSP completions
+- [ ] Full terminal PTY
 
 ---
 
 ## Contributing
 
-1. Fork the repository
-2. Create a feature branch
-3. Run `pnpm check` before committing
-4. Submit a pull request
+1. Fork the repo
+2. Create feature branch
+3. Run `pnpm check:all`
+4. Submit PR
 
-All CI checks must pass before merging.
+All 11 CI checks must pass.
 
 ---
 
-## License
+<div align="center">
+
+**Built with Rust and React**
+
+Private • Recursive Labs
 
-Private - Recursive Labs
+</div>