diff --git a/CHANGELOG.md b/CHANGELOG.md
index b7b92bd..fb99d0c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -16,6 +16,16 @@
 - **sftp_browser_tab.go footer**: Added `Enter/→:open`, `←/Backspace:up`
 - **form tabs footer**: Added `Shift+Tab:prev`, `↑↓:nav`
 
+### Responsive Layout (In Progress)
+- **NEW `responsive.go`**: Shared helpers (`wrapFooter`, `adaptiveSidePad`, `clampWidth`, `truncateStr`)
+- Footer auto-wraps to multi-line when terminal is narrow (full labels preserved)
+- Box width clamped to terminal width — no more overflow
+- Host/key/snippet rows truncated with `…` when names are too long
+- SFTP panes stack vertically when terminal < 50 cols
+- Tab bar truncates tab names on overflow
+- Form contentW minimum lowered to 30 for mobile (Termux)
+- Breakpoints: compact (<60), medium (60–100), wide (≥100)
+
 ## v1.0.0 (2025-01-30)
 
 ### Added
diff --git a/PROJECT_STATE.md b/PROJECT_STATE.md
index e612603..f1d1852 100644
--- a/PROJECT_STATE.md
+++ b/PROJECT_STATE.md
@@ -2,7 +2,7 @@
 
 > **Purpose**: Enable seamless continuation of development by any agent/LLM across sessions
 > 
-> **Last Updated**: 2025-01-31 (TUI Improvements + Storage Fixes)
+> **Last Updated**: 2025-01-31 (Responsive Layout Overhaul)
 > **Current Status**: ✅ MVP Complete — All Tasks 1-14 Done
 > **Phase**: MVP Release (Phase 1)
 
@@ -52,6 +52,16 @@
 ✅ **sftp_browser_tab.go footer**: Added `Enter/→:open`, `←/Backspace:up`
 ✅ **Form tab footers**: Added `Shift+Tab:prev`, `↑↓:nav`
 
+### In Progress: Responsive Layout Overhaul
+🔄 **NEW `responsive.go`**: Shared helpers for adaptive layout (`wrapFooter`, `adaptiveSidePad`, `clampWidth`, `truncateStr`)
+🔄 Footer auto-wraps to multi-line (full labels preserved) — no more overflow on narrow terminals
+🔄 Box width clamped to terminal width across all tabs
+🔄 Host/key/snippet rows truncated with `…` for long names
+🔄 SFTP panes stack vertically when terminal < 50 cols
+🔄 Tab bar truncates names on overflow
+🔄 Form contentW minimum lowered from 50 to 30 for mobile (Termux)
+🔄 Breakpoints: compact (<60 cols / mobile), medium (60–100 / tablet), wide (≥100 / desktop)
+
 ---
 
 ## 📊 Current Project Status