make things editable

README.md

@@ -6,10 +6,14 @@ A fully-featured terminal user interface for browsing SQLite databases built wit
 
 - **Table Browser**: Browse all tables in your SQLite database with pagination
 - **Search Functionality**: Search tables by name using `/` key
-- **Data Viewer**: View table data with pagination (20 rows per page)
+- **Data Viewer**: View table data with pagination and row highlighting
+- **Row-Level Navigation**: Navigate through data rows with cursor highlighting
+- **Data Search**: Search within table data using `/` key
+- **Row Detail Modal**: View individual rows in a 2-column format (Column | Value)
+- **Cell Editing**: Edit individual cell values with live database updates
 - **SQL Query Interface**: Execute custom SQL queries with parameter support
 - **Responsive Design**: Adapts to terminal size and fits content to screen
-- **Navigation**: Intuitive keyboard navigation
+- **Navigation**: Intuitive keyboard navigation throughout all modes
 
 ## Usage
 
@@ -39,11 +43,31 @@ go run main.go sample.db
 - `Backspace`: Delete characters
 
 ### Table Data Mode
+- `↑/↓` or `k/j`: Navigate between data rows (with highlighting)
 - `←/→` or `h/l`: Navigate between data pages
+- `/`: Start searching within table data
+- `Enter`: View selected row in detail modal
 - `Esc`: Return to table list
 - `r`: Refresh current table data
 - `q` or `Ctrl+C`: Quit
 
+### Data Search Mode (when searching within table data)
+- Type to search within all columns of the table
+- `Enter` or `Esc`: Finish search
+- `Backspace`: Delete characters
+
+### Row Detail Modal
+- `↑/↓` or `k/j`: Navigate between fields (Column | Value format)
+- `Enter`: Edit selected field value
+- `Esc`: Return to table data view
+- `q` or `Ctrl+C`: Quit
+
+### Cell Edit Mode
+- Type new value for the selected cell
+- `Enter`: Save changes to database
+- `Esc`: Cancel editing and return to row detail
+- `Backspace`: Delete characters
+
 ### SQL Query Mode
 - Type your SQL query
 - `Enter`: Execute query
@@ -56,13 +80,28 @@ go run main.go sample.db
 1. **Table Browsing**: Lists all tables in the database with pagination
 2. **Table Search**: Filter tables by name using `/` to search
 3. **Paginated Data View**: Shows table data with pagination (20 rows per page)
-4. **Screen-Aware Display**: Content automatically fits terminal size
-5. **SQL Query Execution**: Execute custom SQL queries and view results
-6. **Error Handling**: Displays database errors gracefully
-7. **Responsive UI**: Clean, styled interface that adapts to terminal size
-8. **Column Information**: Shows column names and handles NULL values
-9. **Navigation**: Intuitive keyboard shortcuts for all operations
-10. **Dynamic Column Width**: Columns adjust to terminal width
+4. **Row Highlighting**: Cursor-based row selection with visual highlighting
+5. **Data Search**: Search within table data across all columns
+6. **Row Detail Modal**: 2-column view showing Column | Value for selected row
+7. **Cell Editing**: Live editing of individual cell values with database updates
+8. **Primary Key Detection**: Uses primary keys for reliable row updates
+9. **Screen-Aware Display**: Content automatically fits terminal size
+10. **SQL Query Execution**: Execute custom SQL queries and view results
+11. **Error Handling**: Displays database errors gracefully
+12. **Responsive UI**: Clean, styled interface that adapts to terminal size
+13. **Column Information**: Shows column names and handles NULL values
+14. **Navigation**: Intuitive keyboard shortcuts for all operations
+15. **Dynamic Column Width**: Columns adjust to terminal width
+
+## Navigation Flow
+
+```
+Table List → Table Data → Row Detail → Cell Edit
+     ↓           ↓           ↓           ↓
+   Search     Data Search   Field Nav   Value Edit
+     ↓           ↓           ↓           ↓
+SQL Query    Row Select   Cell Select  Save/Cancel
+```
 
 ## Sample Database
 
@@ -74,4 +113,12 @@ The included `sample.db` contains:
 
 - [Bubble Tea](https://github.com/charmbracelet/bubbletea) - TUI framework
 - [Lip Gloss](https://github.com/charmbracelet/lipgloss) - Styling
-- [go-sqlite3](https://github.com/mattn/go-sqlite3) - SQLite driver
+- [go-sqlite3](https://github.com/mattn/go-sqlite3) - SQLite driver
+
+## Database Updates
+
+The application supports live editing of database records:
+- Uses primary keys when available for reliable row identification
+- Falls back to full-row matching when no primary key exists
+- Updates are immediately reflected in the interface
+- All changes are committed to the database in real-time