Update Docs

Author: Aegis Stack

Makefile

@@ -137,25 +137,18 @@ help: ## Show this help message
 
 gif: ## Convert MP4 to high-quality GIF (usage: make gif INPUT=recording.mp4)
 ifndef INPUT
-	@echo "Usage: make gif INPUT=path/to/video.mp4 [OUTPUT=output.gif] [FPS=15] [WIDTH=1200] [TRIM=2]"
+	@echo "Usage: make gif INPUT=path/to/video.mp4 [OUTPUT=output.gif] [FPS=15] [WIDTH=1200]"
 	@echo ""
 	@echo "Options:"
 	@echo "  INPUT   - Required. Path to input MP4 file"
 	@echo "  OUTPUT  - Optional. Output GIF path (default: same name as input with .gif)"
 	@echo "  FPS     - Optional. Frames per second (default: 15, max 30)"
 	@echo "  WIDTH   - Optional. Output width in pixels (default: 1200)"
-	@echo "  TRIM    - Optional. Seconds to trim from end (default: 0)"
 	@exit 1
 endif
 	@echo "🎬 Converting $(INPUT) to GIF..."
 	@mkdir -p .gif-frames
-ifdef TRIM
-	$(eval DURATION := $(shell ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "$(INPUT)"))
-	$(eval END_TIME := $(shell echo "$(DURATION) - $(TRIM)" | bc))
-	@ffmpeg -i "$(INPUT)" -t $(END_TIME) -vf "fps=$(or $(FPS),15),scale=$(or $(WIDTH),1200):-1:flags=lanczos" -y .gif-frames/frame_%04d.png
-else
 	@ffmpeg -i "$(INPUT)" -vf "fps=$(or $(FPS),15),scale=$(or $(WIDTH),1200):-1:flags=lanczos" -y .gif-frames/frame_%04d.png
-endif
 	@gifski -o "$(or $(OUTPUT),$(basename $(INPUT)).gif)" --fps $(or $(FPS),15) --quality 90 .gif-frames/*.png
 	@rm -rf .gif-frames
 	@echo "✅ Created: $(or $(OUTPUT),$(basename $(INPUT)).gif)"
@@ -171,24 +164,16 @@ endif
 
 gif-demo: ## Convert demo recording to GIF (usage: make gif-demo NAME=overseer)
 ifndef NAME
-	@echo "Usage: make gif-demo NAME=overseer [TRIM=2]"
+	@echo "Usage: make gif-demo NAME=overseer"
 	@echo "  Converts demos/recordings/NAME.mov -> docs/images/NAME-demo.gif"
 	@echo ""
-	@echo "Options:"
-	@echo "  NAME    - Required. Name of recording (without extension)"
-	@echo "  TRIM    - Optional. Seconds to trim from end"
-	@echo ""
 	@echo "Workflow:"
 	@echo "  1. Record screen on Mac"
 	@echo "  2. Save to demos/recordings/NAME.mov"
-	@echo "  3. Run: make gif-demo NAME=NAME TRIM=2"
+	@echo "  3. Run: make gif-demo NAME=NAME"
 	@exit 1
 endif
-ifdef TRIM
-	@$(MAKE) gif INPUT=demos/recordings/$(NAME).mov OUTPUT=docs/images/$(NAME)-demo.gif FPS=30 WIDTH=1920 TRIM=$(TRIM)
-else
 	@$(MAKE) gif INPUT=demos/recordings/$(NAME).mov OUTPUT=docs/images/$(NAME)-demo.gif FPS=30 WIDTH=1920
-endif
 
 # ============================================================================
 # TEMPLATE TESTING TARGETS

README.md

@@ -42,9 +42,9 @@ uvx aegis-stack init task-processor --components scheduler,worker
 cd my-api && uv sync && cp .env.example .env && make serve
 ```
 
-**Installation alternatives:** See the [Installation Guide](docs/installation.md) for `uv tool install`, `pip install`, and development setup.
+**Installation alternatives:** See the [Installation Guide](https://lbedner.github.io/aegis-stack/installation/) for `uv tool install`, `pip install`, and development setup.
 
-## 🌱 Your Stack Grows With You
+## Your Stack Grows With You
 
 **Your choices aren't permanent.** Start with what you need today, add components when requirements change, remove what you outgrow.
 
@@ -60,6 +60,9 @@ aegis add worker --project-path ./my-api
 
 # Month 6: Scheduler not needed
 aegis remove scheduler --project-path ./my-api
+
+# Stay current with template improvements
+aegis update
 ```
 
 | Framework | Add Later? | Remove Later? | Git Conflicts? |
@@ -69,15 +72,15 @@ aegis remove scheduler --project-path ./my-api
 
 ![Component Evolution Demo](docs/images/aegis-evolution-demo.gif)
 
-Most frameworks lock you in at `init`. Aegis Stack doesn't. See **[Evolving Your Stack](docs/evolving-your-stack.md)** for the complete guide.
+Most frameworks lock you in at `init`. Aegis Stack doesn't. See **[Evolving Your Stack](https://lbedner.github.io/aegis-stack/evolving-your-stack/)** for the complete guide.
 
 ## See It In Action
 
 ### Overseer - Built-In Health Monitoring
 
 ![Overseer](docs/images/overseer-demo.gif)
 
-**[Overseer](docs/overseer/index.md)** is the read-only health monitoring dashboard built into every Aegis Stack project. It provides real-time visibility into all your components (Backend, Database, Worker, Scheduler) and services (Auth, AI, Comms) through a web UI and CLI commands.
+**[Overseer](https://lbedner.github.io/aegis-stack/overseer/)** is the read-only health monitoring dashboard built into every Aegis Stack project. It provides real-time visibility into all your components (Backend, Database, Worker, Scheduler) and services (Auth, AI, Comms) through a web UI and CLI commands.
 
 No Datadog. No New Relic. No vendor lock-in. Just centralized monitoring you own from day one.
 
@@ -89,30 +92,27 @@ Rich terminal output showing detailed component status, health metrics, and syst
 
 ## Available Components & Services
 
-### Infrastructure Components
-| Component | Purpose | Status |
-|-----------|---------|--------|
-| **Core** (FastAPI + Flet) | Web API + Frontend | ✅ **Always Included** |
-| **Database** | SQLite + SQLModel ORM | ✅ **Available** |
-| **Scheduler** | Background tasks, cron jobs | ✅ **Available** |
-| **Worker** | Async task queues (arq + Redis) | 🧪 **Experimental** |
-| **Cache** | Redis caching and sessions | 🚧 **Coming Soon** |
+**Components** (infrastructure)
+
+- **Core** - FastAPI + Flet (always included)
+- **Database** - SQLite + SQLModel ORM
+- **Scheduler** - Background tasks, cron jobs
+- **Worker** - Async task queues (arq + Redis)
+
+**Services** (business logic)
 
-### Business Services
-| Service | Purpose | Status |
-|---------|---------|--------|
-| **[Auth](docs/services/auth/index.md)** | User authentication & JWT | ✅ **Available** |
-| **[AI](docs/services/ai/index.md)** | Multi-provider AI chat | 🧪 **Experimental** |
-| **[Comms](docs/services/comms/index.md)** | Email, SMS, voice calls | 🧪 **Experimental** |
+- **[Auth](https://lbedner.github.io/aegis-stack/services/auth/)** - User authentication & JWT
+- **[AI](https://lbedner.github.io/aegis-stack/services/ai/)** - Multi-provider AI chat
+- **[Comms](https://lbedner.github.io/aegis-stack/services/comms/)** - Email, SMS, voice calls
 
-**See detailed documentation:** [Components →](docs/components/index.md) | [Services →](docs/services/index.md)
+[Components Docs →](https://lbedner.github.io/aegis-stack/components/) | [Services Docs →](https://lbedner.github.io/aegis-stack/services/)
 
 ## Learn More
 
-- **[CLI Reference](docs/cli-reference.md)** - Complete command reference
-- **[About](docs/about.md)** - The philosophy and vision behind Aegis Stack
-- **[Evolving Your Stack](docs/evolving-your-stack.md)** - Add/remove components as needs change
-- **[Technology Stack](docs/technology.md)** - Battle-tested technology choices
+- **[CLI Reference](https://lbedner.github.io/aegis-stack/cli-reference/)** - Complete command reference
+- **[About](https://lbedner.github.io/aegis-stack/about/)** - The philosophy and vision behind Aegis Stack
+- **[Evolving Your Stack](https://lbedner.github.io/aegis-stack/evolving-your-stack/)** - Add/remove components as needs change
+- **[Technology Stack](https://lbedner.github.io/aegis-stack/technology/)** - Battle-tested technology choices
 
 ## For The Veterans
 

aegis/__main__.py

@@ -24,14 +24,14 @@
 app = typer.Typer(
     name="aegis",
     help=(
-        "🛡️ Aegis Stack - Production-ready Python foundation\n\n"
+        "Aegis Stack - Production-ready Python foundation\n\n"
         "Quick start: uvx aegis-stack init my-project\n\n"
         "Available components: redis, worker, scheduler, scheduler[sqlite], database\n"
         "Backend selection: Use --backend flag or bracket syntax (sqlite only)"
     ),
     epilog=(
-        "💡 Try it instantly: uvx aegis-stack init my-project\n"
-        "📚 More info: https://lbedner.github.io/aegis-stack/"
+        "Try it instantly: uvx aegis-stack init my-project\n"
+        "More info: https://lbedner.github.io/aegis-stack/"
     ),
     add_completion=False,
 )

aegis/cli/callbacks.py

@@ -34,7 +34,7 @@ def validate_and_resolve_components(
 
     # Check for empty components before filtering
     if any(not c for c in components_raw):
-        typer.echo("❌ Empty component name is not allowed", err=True)
+        typer.secho("Empty component name is not allowed", fg="red", err=True)
         raise typer.Exit(1)
 
     selected = [c for c in components_raw if c]
@@ -47,7 +47,7 @@ def validate_and_resolve_components(
     errors = DependencyResolver.validate_components(clean_selected)
     if errors:
         for error in errors:
-            typer.echo(f"❌ {error}", err=True)
+            typer.secho(error, fg="red", err=True)
         raise typer.Exit(1)
 
     # Resolve dependencies (using clean names)
@@ -60,13 +60,13 @@ def validate_and_resolve_components(
     original_clean = clean_component_names(selected)
     auto_added = DependencyResolver.get_missing_dependencies(original_clean)
     if auto_added:
-        typer.echo(f"📦 Auto-added dependencies: {', '.join(auto_added)}")
+        typer.echo(f"Auto-added dependencies: {', '.join(auto_added)}")
 
     # Show recommendations
     recommendations = DependencyResolver.get_recommendations(resolved_clean)
     if recommendations:
         rec_list = ", ".join(recommendations)
-        typer.echo(f"💡 Recommended: {rec_list}")
+        typer.echo(f"Recommended: {rec_list}")
         # Note: Skip interactive recommendations for now to keep it simple
 
     return resolved
@@ -89,15 +89,17 @@ def validate_and_resolve_services(
 
     # Check for empty services before filtering
     if any(not s for s in services_raw):
-        typer.echo("❌ Empty service name is not allowed", err=True)
+        typer.secho("Empty service name is not allowed", fg="red", err=True)
         raise typer.Exit(1)
 
     selected_services = [s for s in services_raw if s]
 
     # Validate services exist
     unknown_services = [s for s in selected_services if s not in SERVICES]
     if unknown_services:
-        typer.echo(f"❌ Unknown services: {', '.join(unknown_services)}", err=True)
+        typer.secho(
+            f"Unknown services: {', '.join(unknown_services)}", fg="red", err=True
+        )
         available = list(SERVICES.keys())
         typer.echo(f"Available services: {', '.join(available)}", err=True)
         raise typer.Exit(1)
@@ -109,6 +111,6 @@ def validate_and_resolve_services(
 
     # Show what components were added by services
     if service_added:
-        typer.echo(f"📦 Services require components: {', '.join(service_added)}")
+        typer.echo(f"Services require components: {', '.join(service_added)}")
 
     return selected_services