initial commit

Signed-off-by: ale <ale@manalejandro.com>

docs/QUICK_START.md

@@ -0,0 +1,119 @@
+# Buque Docker Compose Manager
+
+## Quick Links
+
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Commands](#commands)
+- [Examples](#examples)
+- [Configuration](#configuration)
+
+## Installation
+
+### Requirements
+- Go 1.21+
+- Docker 20.10+
+- Docker Compose V2
+
+### Install from source
+
+```bash
+git clone https://github.com/yourusername/buque.git
+cd buque
+make install
+```
+
+## Quick Start
+
+```bash
+# Initialize
+buque init
+
+# Deploy nginx-proxy
+buque proxy deploy
+
+# Add environment
+buque env add myapp /path/to/myapp
+
+# Start environment
+buque up myapp
+
+# Monitor containers
+buque stats --continuous
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `buque init` | Initialize configuration |
+| `buque env add <name> <path>` | Add environment |
+| `buque env list` | List environments |
+| `buque up [env...]` | Start environments |
+| `buque down [env...]` | Stop environments |
+| `buque restart [env...]` | Restart environments |
+| `buque update [env...]` | Update environments |
+| `buque stats [env]` | Show statistics |
+| `buque logs <env>` | View logs |
+| `buque ps [env...]` | List containers |
+| `buque proxy deploy` | Deploy nginx-proxy |
+| `buque pull [env...]` | Pull images |
+| `buque prune` | Clean up resources |
+
+## Examples
+
+### Basic docker-compose.yml with nginx-proxy
+
+```yaml
+version: '3.8'
+services:
+  web:
+    image: nginx:alpine
+    expose:
+      - "80"
+    environment:
+      - VIRTUAL_HOST=example.com
+      - LETSENCRYPT_HOST=example.com
+    networks:
+      - nginx-proxy
+    labels:
+      - "buque.environment=myapp"
+networks:
+  nginx-proxy:
+    external: true
+```
+
+### Monitoring
+
+```bash
+# Real-time stats
+buque stats --continuous --interval 2
+
+# Sort by memory
+buque stats --sort memory
+
+# Environment-specific
+buque stats webapp
+```
+
+## Configuration
+
+Default location: `~/.buque/config.yaml`
+
+```yaml
+environments:
+  - name: webapp
+    path: /path/to/webapp
+    enabled: true
+
+nginx_proxy:
+  enabled: true
+  network_name: nginx-proxy
+  http_port: 80
+  https_port: 443
+  ssl_enabled: true
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details