docs: overhaul README for a professional user-focused experience

- Standardized sections with a focus on story and features
- Added modern badges for release, build status, and license
- Simplified installation guide with direct release links
- Refined technical descriptions for better clarity

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: kaan-escober

README.md

@@ -1,71 +1,57 @@
 # Hacker Keyboard: Tokyo Night
 
-A modernization project of the legendary Hacker's Keyboard, bringing aesthetic and modern Android UX to the most powerful soft keyboard ever made.
+![Latest Release](https://img.shields.io/github/v/release/umairimtiaz9/hackerkeyboard-tokyonight?label=Latest%20Build&color=7aa2f7&style=for-the-badge)
+![Build Status](https://img.shields.io/github/actions/workflow/status/umairimtiaz9/hackerkeyboard-tokyonight/android.yml?branch=master&style=for-the-badge&label=Build)
+![License](https://img.shields.io/github/license/umairimtiaz9/hackerkeyboard-tokyonight?style=for-the-badge&color=9ece6a)
 
-[CHANGELOG](CHANGELOG.md)
+A professional modernization of the legendary **Hacker's Keyboard**. This project brings a premium, high-performance aesthetic and modern Android UX to the most powerful soft keyboard ever made, featuring the iconic **Tokyo Night** design system.
 
 ![Modern Preview](screenshots/hk-5row-us.jpg)
 
-## 📜 The History: From 2011 to Today
+## 📜 The Story
 
-Hacker's Keyboard was originally developed in 2011, based on the Android 2.3 (Gingerbread) AOSP keyboard. It became the gold standard for power users, developers, and sysadmins due to its full 5-row layout, working Tab/Ctrl/Esc keys, and essential arrow keys for SSH and terminal usage.
+Hacker's Keyboard was originally developed in 2011, based on the Gingerbread-era AOSP keyboard. It became the gold standard for power users, developers, and sysadmins due to its full 5-row layout, working Tab/Ctrl/Esc keys, and essential arrow keys for SSH and terminal usage.
 
-### The Modernization Journey
-This project transforms the "ancient" Gingerbread-style UI into a professional, data-driven modernization:
-- **Phase I**: Purged 14+ inconsistent legacy themes and replaced them with the **Tokyo Night** design system.
-- **Phase II**: Overhauled the core rendering logic from static bitmap nine-patches to a dynamic, attribute-driven XML system.
-- **Phase III**: Refined interaction design with fluid animations, designer typography, and "AnySoft" style continuous stroke popups.
+This project carries that legacy forward, replacing decade-old assets and rendering logic with a data-driven architecture and a professional design language inspired by modern IDEs.
 
-## ✨ Key Features (Modernized)
+---
+
+## ✨ Key Features
 
 ### 🎨 Tokyo Night Design System
 Integrated 4 high-contrast variants based on the popular Neovim color scheme:
-- **Storm** (Default): A balanced, deep blue-grey.
-- **Night**: Darker, more intense tones for AMOLED/OLED and low-light.
-- **Moon**: A slightly softer, cooler midnight palette.
-- **Day**: A crisp, high-legibility light theme.
+- **Storm** (Default): A balanced, deep blue-grey for all-day focus.
+- **Night**: Darker, more intense tones—perfect for OLED screens.
+- **Moon**: A slightly softer midnight palette for reduced eye strain.
+- **Day**: A crisp, high-legibility light theme for bright environments.
 
 ### ⌨️ Professional Typography
-- **Google Sans Code Integration**: Integrated designer typography across all keys and popups for superior professional legibility.
-- **Typographic Hierarchy**: High-opacity bold labels for primary functions and low-opacity hint characters for reduced visual noise
+- **Google Sans Code**: Designer monospace typography integrated across all keys and popups for superior legibility.
+- **Typographic Hierarchy**: High-opacity labels for primary functions with subtle "Hint" characters to reduce visual noise.
 
+### 🚀 Fluid Interactions
+- **Seamless Popups**: Our custom `SeamlessPopupDrawable` engine renders keys and popups as a single, continuous shape, eliminating the "floating box" feel of legacy keyboards.
+- **Spring Physics**: Responsive animations provide tactile, snappy feedback.
+- **Zero Latency**: Optimized for power users with 0ms popup delays and dynamic long-press triggers.
 
-## 🛠 Technical Architecture
+---
 
-The project has been migrated to a modern, semantic architecture:
+## 📥 Installation
 
-### 1. Data-Oriented Colors (`attrs.xml`)
-Themes are no longer hardcoded. We use semantic roles to define the palette:
-- `kbdColorBase`: Main keyboard tray background.
-- `kbdColorAlpha`: Standard character key background.
-- `kbdColorMod`: Functional key background (Shift, Ctrl, Alt).
-- `kbdColorHighlight`: Pressed or Sticky (Locked) states.
-- `kbdColorText`: Global label and icon color.
-- `kbdColorPopup`: Border/Stroke color for overlays.
+The fastest way to get started is to download the latest signed APK:
 
-### 2. Unified Asset System
-Instead of maintaining dozens of bitmap files, we use a single, high-fidelity XML drawable system:
-- `btn_key_tokyonight.xml`: Handles all key states with 2dp insets for a guaranteed 4dp visual gutter.
-- **Vector Icons**: All keyboard symbols are vector-based and surgically tinted via theme attributes.
+1.  **Download**: Get the latest signed APK from the [**Releases Page**](https://github.com/umairimtiaz9/hackerkeyboard-tokyonight/releases/tag/latest).
+2.  **Install**: Open the `.apk` file on your Android device.
+3.  **Enable**: Go to **Settings > System > Languages & input > On-screen keyboard** and enable "Hacker's Keyboard".
+4.  **Enjoy**: Switch your input method and select your favorite Tokyo Night variant in the keyboard settings.
 
-### 3. Java Integration
-- **ContextThemeWrapper**: Injects theme attributes at runtime before layout inflation.
-- **Dynamic Connection Patch**: Real-time positioning of an invisible overlay to merge keys and popups visually.
+---
 
 ## 🤝 Contributing
 
-We welcome contributions! This project aims to maintain the "power user" soul of Hacker's Keyboard while keeping the UI modern.
-
-1. **Bug Fixes**: Help us resolve any legacy rendering issues on modern Android versions.
-2. **Themes**: While Tokyo Night is the focus, the dynamic system allows for easy addition of new high-quality color schemes.
-
-## 📥 Installation
-
-1. Clone this repository.
-2. Build using Android Studio or via Gradle.
-3. Enable "Hacker's Keyboard" in your Android system settings.
+We welcome contributions that respect the "power user" soul of Hacker's Keyboard while adhering to the modern Tokyo Night visual guidelines. Whether it's language layouts, bug fixes, or theme refinements, your help is appreciated.
 
-*Or Simply download & install from releases.*
 ---
 
 *Based on the original work by Klaus Weidner.*
+[Changelog](CHANGELOG.md) | [History](https://github.com/klausw/hackerskeyboard)