docs: Update docs-site README with deployment info and library overview

Author: mashrulhaque

docs-site/README.md

@@ -2,7 +2,21 @@
 
 Modern, interactive documentation website for EasyAppDev.Blazor.Store built with React and Vite.
 
-## Features
+**🌐 Live Site:** [https://mashrulhaque.github.io/EasyAppDev.Blazor.Store/](https://mashrulhaque.github.io/EasyAppDev.Blazor.Store/)
+
+## About the Library
+
+**EasyAppDev.Blazor.Store** is a Zustand-inspired state management library for Blazor applications. It emphasizes simplicity, type safety, and immutability with minimal boilerplate.
+
+**Key Library Features:**
+- ✨ **Zero boilerplate** - Write state methods, not actions/reducers
+- 🔒 **Immutable by default** - C# records + `with` expressions
+- 🎯 **Automatic reactivity** - Components update automatically
+- ⚡ **5 async helpers** - UpdateDebounced, AsyncData<T>, ExecuteAsync, UpdateThrottled, LazyLoad (74% code reduction)
+- 📦 **Tiny** - Only 38 KB gzipped
+- 🧰 **Redux DevTools** - Time-travel debugging
+
+## Documentation Site Features
 
 - 📚 **Multi-Page Documentation** - Comprehensive coverage of all library features
 - 🎨 **Syntax Highlighting** - Beautiful code examples with Prism.js
@@ -44,12 +58,44 @@ npm run build
 
 The built site will be in the `dist/` directory.
 
+For GitHub Pages deployment, the build uses the `GITHUB_PAGES=true` environment variable to set the correct base path:
+
+```bash
+GITHUB_PAGES=true npm run build
+```
+
 ### Preview Production Build
 
 ```bash
 npm run preview
 ```
 
+## Deployment
+
+The documentation site is automatically deployed to GitHub Pages via GitHub Actions.
+
+### Automatic Deployment
+
+The site deploys automatically when:
+- Changes are pushed to the `main` branch
+- Files in `docs-site/**` are modified
+- The workflow file `.github/workflows/deploy-docs.yml` is changed
+
+### Manual Deployment
+
+You can manually trigger a deployment:
+1. Go to the [Actions tab](https://github.com/mashrulhaque/EasyAppDev.Blazor.Store/actions)
+2. Select "Deploy Docs to GitHub Pages"
+3. Click "Run workflow" → Select "main" branch → "Run workflow"
+
+### Deployment Configuration
+
+The deployment is configured via:
+- **Workflow:** `.github/workflows/deploy-docs.yml`
+- **Base Path:** Set in `vite.config.js` via `process.env.GITHUB_PAGES`
+- **Router:** React Router uses `basename={import.meta.env.BASE_URL}`
+- **Output:** `dist/` directory is deployed to GitHub Pages
+
 ## Project Structure
 
 ```
@@ -241,10 +287,11 @@ MIT © EasyAppDev
 
 ## Support
 
-For issues or questions about the documentation:
-- Open an issue on GitHub
-- Check existing documentation
-- Review code examples
+For issues or questions:
+- **Library Issues:** [GitHub Issues](https://github.com/mashrulhaque/EasyAppDev.Blazor.Store/issues)
+- **Documentation Issues:** Open an issue with the `documentation` label
+- **Main Repository:** [EasyAppDev.Blazor.Store](https://github.com/mashrulhaque/EasyAppDev.Blazor.Store)
+- **NuGet Package:** [EasyAppDev.Blazor.Store](https://www.nuget.org/packages/EasyAppDev.Blazor.Store/)
 
 ---