docs: Enhance project documentation and metadata with detailed descriptions, use cases, safety information, and updated branding.

Author: Bharath-code

README.md

@@ -8,10 +8,25 @@
 [![GitHub stars](https://img.shields.io/github/stars/Bharath-code/git-scope)](https://github.com/Bharath-code/git-scope/stargazers)
 [![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-FFDD00?style=flat&logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/iam_pbk)
 
+🌐 **Website:** [bharath-code.github.io/git-scope](https://bharath-code.github.io/git-scope/)
+
 ![git-scope Demo](docs/git-scope-demo-1.webp)
 
 ---
 
+## 🛡️ Trust & Safety
+
+git-scope is designed to be safe to run frequently and safe to recommend.
+
+- **Read-only by design** — it does not modify repositories
+- **Local-first** — no network access, no telemetry, no accounts
+- **Predictable** — no background services or daemons
+- **Conservative scope** — focused on visibility, not automation
+
+These choices make git-scope suitable for daily use and work environments where reliability and transparency matter.
+
+---
+
 ## ⚡ Installation
 
 Get started in seconds.
@@ -94,6 +109,25 @@ git-scope -h           # Show help
 
 -----
 
+## 🎯 Use Cases
+
+git-scope excels in environments where multi-repo complexity is a daily burden:
+
+*   **Microservices Management** — Quickly verify if all your services are on the correct branch and have no unpushed changes.
+*   **OSS Contribution Tracking** — Keep tabs on various upstream forks and personal branches in one view.
+*   **Infrastructure as Code (IaC)** — Monitor multiple Terraform/CloudFormation repos for configuration drift or uncommitted edits.
+*   **Context Recovery** — Instantly see where you left off after a weekend or a holiday without running `git status` 20 times.
+
+-----
+
+## 🏆 The git-scope Advantage
+
+While many Git tools focus on the *micro* (committing, staging, diffing), git-scope is built for the *macro*.
+
+Typical git workflows involve "tunnel vision"—working deep inside one repository. git-scope provides the "command center" view. It is intentionally **read-only**, **local-first**, and **blazing fast** (<10ms), making it the perfect companion to tools like `lazygit`, `gitui`, or VS Code.
+
+-----
+
 ## ⌨️ Keyboard Shortcuts
 
 | Key | Action |
@@ -156,11 +190,43 @@ I built `git-scope` to solve the **"Multi-Repo Blindness"** problem. It gives me
 
   - [x] In-app workspace switching with Tab completion
   - [x] Symlink resolution for devcontainers/Codespaces
-  - [ ] Background file watcher (real-time updates)
+  - [x] Background file watcher (real-time updates)
   - [ ] Quick actions (bulk pull/fetch)
   - [ ] Repo grouping (Service / Team / Stack)
   - [ ] Custom team dashboards
 
+## ❓ FAQ
+
+### How do you manage multiple Git repositories locally?
+
+git-scope provides a fast, read-only terminal dashboard that shows the status of many local Git repositories at once. It helps developers regain context across projects without switching directories or running commands repeatedly.
+
+### What problem does git-scope solve?
+
+git-scope reduces context switching when working across many Git repositories, such as microservices, tools, or configuration repos. It gives a single overview of repository state so developers can quickly see what needs attention.
+
+### Is git-scope safe to use at work?
+
+Yes. git-scope is read-only by design, runs entirely locally, has no network access or telemetry, and does not modify repositories. This makes it safe for daily and work use.
+
+### Does git-scope replace git commands?
+
+No. git-scope does not perform git actions like commit, push, or pull. It focuses on visibility and orientation, not automation.
+
+### Is git-scope suitable for monorepos?
+
+git-scope is designed for multi-repo (polyrepo) workflows. It is not intended to manage monorepos.
+
+### What platforms does git-scope support?
+
+git-scope runs on macOS, Linux, and Windows.
+
+### How is git-scope different from other git TUIs?
+
+Most git TUIs focus on interacting with a single repository. git-scope focuses on visibility across many repositories and stays intentionally read-only.
+
+---
+
 ## 📄 License
 
 MIT © [Bharath-code](https://github.com/Bharath-code)

docs/index.html

@@ -20,15 +20,27 @@
     {
       "@context": "https://schema.org",
       "@type": "SoftwareApplication",
-      "name": "Git-Scope",
+      "name": "git-scope",
+      "softwareVersion": "1.3.x",
       "applicationCategory": "DeveloperApplication",
+      "applicationSubCategory": "Git Terminal Interface / Dashboard",
       "operatingSystem": "macOS, Linux, Windows",
       "offers": {
         "@type": "Offer",
         "price": "0",
         "priceCurrency": "USD"
       },
       "description": "A blazing fast TUI to manage, search, and clean up all your local git repositories. Zero config required.",
+      "screenshot": "https://bharath-code.github.io/git-scope/git-scope-demo-1.webp",
+      "featureList": [
+        "Workspace Switcher (~, relative paths, symlinks)",
+        "Fuzzy Search (name, path, branch)",
+        "Dirty Filter (find unstaged/uncommitted changes)",
+        "Blazing Fast (JSON caching, <10ms startup)",
+        "Disk Usage Visualizer (git vs node_modules)",
+        "Local Heatmap (contribution graph)",
+        "Timeline View (recent activity across all projects)"
+      ],
       "author": {
         "@type": "Person",
         "name": "Bharath Kumar",
@@ -40,17 +52,17 @@
     <!-- Open Graph / Facebook -->
     <meta property="og:type" content="website">
     <meta property="og:url" content="https://bharath-code.github.io/git-scope/">
-    <meta property="og:title" content="Git-Scope | Control Your Git Universe">
+    <meta property="og:title" content="git-scope | Multi-Repo Terminal Dashboard">
     <meta property="og:description"
-        content="A blazing fast TUI to manage, search, and clean up all your local git repositories. Zero config required.">
+        content="Visualize your entire Git workspace in one screen. A fast, read-only TUI for managing microservices, OSS forks, and complex projects.">
     <meta property="og:image" content="https://bharath-code.github.io/git-scope/og-image.png">
 
     <!-- Twitter -->
     <meta property="twitter:card" content="summary_large_image">
     <meta property="twitter:url" content="https://bharath-code.github.io/git-scope/">
-    <meta property="twitter:title" content="Git-Scope | Control Your Git Universe">
+    <meta property="twitter:title" content="git-scope | Multi-Repo Terminal Dashboard">
     <meta property="twitter:description"
-        content="A blazing fast TUI to manage, search, and clean up all your local git repositories. Zero config required.">
+        content="Visualize your entire Git workspace in one screen. A fast, read-only TUI for managing microservices and complex projects.">
     <meta property="twitter:image" content="https://bharath-code.github.io/git-scope/og-image.png">
 
     <!-- Fonts -->
@@ -1570,7 +1582,7 @@ <h1 class="hero-animate">Stop <span class="gradient-text">cd-ing.</span> <br> St
                             <picture>
                                 <source media="(max-width: 768px)" srcset="git-scope-demo-mobile-1.webp"
                                     type="image/webp">
-                                <img src="git-scope-demo-1.webp" alt="Git Scope Demo" loading="eager" width="1200"
+                                <img src="git-scope-demo-1.webp" alt="git-scope Demo" loading="eager" width="1200"
                                     height="800" style="width: 100%; height: auto; display: block;" decoding="async">
                             </picture>
                         </div>