From bd53db62e8257e94cf7824d69a947e655ed0b326 Mon Sep 17 00:00:00 2001
From: Shozikan <142514207+Youwes09@users.noreply.github.com>
Date: Sat, 21 Feb 2026 08:06:40 -0600
Subject: [PATCH] [BETA] Updated README

Updated README to improve layout, added feature list, and clarified installation instructions.
---
 README.md | 55 ++++++++++++++++++++++++++++++++++++++++++++-----------
 1 file changed, 44 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index e00942b..fb3c6c7 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,39 @@
 <div align="center">
-  <img src="src/assets/Moku-Icon.svg" width="80" />
-  <h1>Moku</h1>
-  <p>A manga reader frontend for <a href="https://github.com/Suwayomi/Suwayomi-Server">Suwayomi-Server</a>, built with Tauri and React.</p>
+  <img src="src/assets/Moku-Icon.svg" width="256" style="display:block;margin:0 auto;" />
+  <h1 style="margin:4px 0 2px;">Moku</h1>
+  <p style="margin:0 0 12px;">A fast, minimal manga reader frontend for <a href="https://github.com/Suwayomi/Suwayomi-Server">Suwayomi-Server</a>, built with Tauri and React.</p>
+
+  <table>
+    <tr>
+      <td><img src=".github/screenshots/Library-Page.png" width="100%" /></td>
+      <td><img src=".github/screenshots/Libary-Browse.png" width="100%" /></td>
+      <td><img src=".github/screenshots/Series-Detail.png" width="100%" /></td>
+    </tr>
+    <tr>
+      <td><img src=".github/screenshots/Search-Bar.png" width="100%" /></td>
+      <td><img src=".github/screenshots/Download-Manager.png" width="100%" /></td>
+      <td><img src=".github/screenshots/Settings-1.png" width="100%" /></td>
+    </tr>
+  </table>
 </div>
 
 ---
 
+## Features
+
+- Library management with cover art browsing
+- Full manga reader with keyboard navigation
+- Chapter download queue
+- Extension and source management
+- Reading history tracking
+
 ## Requirements
 
-- [Suwayomi-Server](https://github.com/Suwayomi/Suwayomi-Server) running on `http://127.0.0.1:4567`
+[Suwayomi-Server](https://github.com/Suwayomi/Suwayomi-Server) must be running at `http://127.0.0.1:4567`.
 
 ## Installation
 
-### Nix
+**Nix (recommended)**
 
 ```bash
 nix run github:Youwes09/moku
@@ -24,7 +45,7 @@ Or add to your flake:
 inputs.moku.url = "github:Youwes09/moku";
 ```
 
-### From source
+**From source**
 
 ```bash
 git clone https://github.com/Youwes09/moku
@@ -43,8 +64,20 @@ pnpm tauri dev
 
 ## Stack
 
-- [Tauri v2](https://tauri.app) — app shell
-- [React](https://react.dev) + [TypeScript](https://www.typescriptlang.org) — UI
-- [Vite](https://vitejs.dev) — frontend build
-- [Zustand](https://zustand-demo.pmnd.rs) — state
-- [Crane](https://github.com/ipetkov/crane) — Nix Rust builds
\ No newline at end of file
+| | |
+|---|---|
+| [Tauri v2](https://tauri.app) | App shell |
+| [React](https://react.dev) + [TypeScript](https://www.typescriptlang.org) | UI |
+| [Vite](https://vitejs.dev) | Frontend build |
+| [Zustand](https://zustand-demo.pmnd.rs) | State management |
+| [Crane](https://github.com/ipetkov/crane) | Nix Rust builds |
+
+## License
+
+Distributed under the [Apache 2.0 License](./LICENSE).
+
+---
+
+## Disclaimer
+
+Moku does not host any content. The developer(s) of this application have no affiliation with the content providers available freely on the internet.