docs: finalize landing pages

Author: barreeeiroo

README.md

@@ -17,16 +17,34 @@ depending on vendor-specific capabilities.
 
 ## Features
 
-- **Multi-Backend Replication**: Replicate data across multiple S3-compatible storage backends
-- **Flexible Replication Modes**: Choose between async (fast) and synchronous (consistent) replication
-- **Multiple Read Strategies**: From fast primary-only reads to consistency-verified reads across all backends
-- **Streaming Architecture**: Zero-copy streaming for efficient handling of large objects
-- **S3-Compatible API**: Drop-in replacement for S3-compatible applications
-
-## Getting Started
-
-For installation instructions, configuration options, and usage examples, please refer to the
-[documentation](https://diego.barreiro.dev/ReplicaT4/).
+- **Multi-Backend Replication** - Replicate across any S3-compatible storage (AWS S3, MinIO, Backblaze B2, etc.)
+- **Flexible Write Modes** - Async replication (fast) or multi-sync (consistent)
+- **Smart Read Strategies** - Primary-only, fallback, best-effort, or all-consistent modes
+- **Streaming Architecture** - Zero-copy streaming for efficient large object handling
+- **Drop-in Replacement** - Standard S3 API, no application code changes required
+
+## Quick Start
+
+```bash
+# 1. Create config.json with your backends
+# 2. Run with Docker
+docker run -d -p 3000:3000 \
+  -v $(pwd)/config.json:/app/config.json:ro \
+  -e AWS_ACCESS_KEY_ID=MYKEY \
+  -e AWS_SECRET_ACCESS_KEY=MYSECRET \
+  ghcr.io/barreeeiroo/replicat4:latest
+
+# 3. Use standard S3 tools
+aws s3 ls s3://mybucket/ --endpoint-url http://localhost:3000
+```
+
+## Documentation
+
+- **[Getting Started](https://diego.barreiro.dev/ReplicaT4/getting-started/)** - Installation and setup guide
+- **[Motivation](https://diego.barreiro.dev/ReplicaT4/motivation/)** - Why ReplicaT4 exists and the problem it solves
+- **[Configuration](https://diego.barreiro.dev/ReplicaT4/configuration/)** - Complete configuration reference
+- **[Read/Write Modes](https://diego.barreiro.dev/ReplicaT4/read-write-modes/)** - Understanding replication strategies
+- **[Usage Examples](https://diego.barreiro.dev/ReplicaT4/usage-examples/)** - Common usage scenarios
 
 ## Acknowledgments
 

docs/docs/index.md

@@ -2,8 +2,111 @@
 icon: lucide/home
 ---
 
-# About ReplicaT4
+# ReplicaT4
 
 An **S3-compatible proxy server that intercepts and replicates object storage operations across multiple
 backends** simultaneously. Supports any S3-compatible storage (AWS S3, MinIO, Backblaze B2, etc.) as
 replication targets.
+
+ReplicaT4 sits transparently between your applications and storage providers, enabling multi-cloud replication without modifying application code.
+
+```mermaid
+graph LR
+    App[Your Application<br/>Standard S3 Client]
+    style App fill:#51cf66,stroke:#2f9e44,stroke-width:2px,color:#000
+
+    Proxy[ReplicaT4<br/>Proxy Server]
+    style Proxy fill:#339af0,stroke:#1864ab,stroke-width:2px,color:#fff
+
+    B1[AWS S3]
+    B2[Backblaze B2]
+    B3[MinIO]
+
+    App -->|S3 API| Proxy
+    Proxy -->|Replicate| B1
+    Proxy -->|Replicate| B2
+    Proxy -->|Replicate| B3
+```
+
+## Key Benefits
+
+- **Zero Code Changes** - Your applications continue using standard S3 APIs
+- **Provider Agnostic** - Mix and match any S3-compatible storage providers
+- **Flexible Consistency** - Choose between fast async or strong sync replication
+- **Cost Optimization** - Combine budget providers while maintaining multi-location durability
+- **Vendor Independence** - Protect against provider-specific failures or lock-in
+
+## Getting Started
+
+<div class="grid cards" markdown>
+
+-   :material-rocket-launch: **[Getting Started](getting-started.md)**
+
+    ---
+
+    Install ReplicaT4, create your configuration, and run your first replication in minutes.
+
+-   :lucide-brain: **[Motivation](motivation.md)**
+
+    ---
+
+    Learn why ReplicaT4 exists and how it solves the durability vs. cost trade-off.
+
+-   :material-cog: **[Configuration](configuration.md)**
+
+    ---
+
+    Complete reference for all configuration options and backend setup.
+
+-   :material-swap-horizontal: **[Read/Write Modes](read-write-modes.md)**
+
+    ---
+
+    Understand replication strategies and choose the right mode for your use case.
+
+-   :material-application-brackets: **[Usage Examples](usage-examples.md)**
+
+    ---
+
+    Common scenarios and real-world configurations for different requirements.
+
+</div>
+
+## Quick Example
+
+```json title="config.json"
+{
+  "virtualBucket": "mybucket",
+  "readMode": "PRIMARY_FALLBACK",
+  "writeMode": "ASYNC_REPLICATION",
+  "backends": [
+    {
+      "type": "s3",
+      "name": "aws-primary",
+      "region": "us-east-1",
+      "bucket": "my-aws-bucket"
+    },
+    {
+      "type": "s3",
+      "name": "backblaze-backup",
+      "region": "us-west-004",
+      "bucket": "my-b2-bucket",
+      "endpoint": "https://s3.us-west-004.backblazeb2.com"
+    }
+  ]
+}
+```
+
+```bash
+# Run with Docker
+docker run -d -p 3000:3000 \
+  -v $(pwd)/config.json:/app/config.json:ro \
+  -e AWS_ACCESS_KEY_ID=MYKEY \
+  -e AWS_SECRET_ACCESS_KEY=MYSECRET \
+  ghcr.io/barreeeiroo/replicat4:latest
+
+# Use with any S3-compatible tool
+aws s3 cp myfile.txt s3://mybucket/ --endpoint-url http://localhost:3000
+```
+
+Data is now automatically replicated to both AWS S3 and Backblaze B2!