Add deployment profiles

Makefile

@@ -164,6 +164,8 @@ docker-prune:
 # =============================================================================
 
 .PHONY: fly-validate fly-preview fly-deploy fly-status fly-logs fly-ssh
+.PHONY: fly-preview-demo fly-preview-production fly-preview-development
+.PHONY: fly-deploy-demo fly-deploy-production fly-deploy-development
 
 # validate fly.io configuration
 fly-validate:
@@ -173,10 +175,34 @@ fly-validate:
 fly-preview:
 	./scripts/deployment/preview_fly_secrets.sh
 
+# preview deployment with demo profile
+fly-preview-demo:
+	./scripts/deployment/preview_fly_secrets.sh --profile demo
+
+# preview deployment with production profile  
+fly-preview-production:
+	./scripts/deployment/preview_fly_secrets.sh --profile production
+
+# preview deployment with development profile
+fly-preview-development:
+	./scripts/deployment/preview_fly_secrets.sh --profile development
+
 # deploy to fly.io (reads .env file automatically)
 fly-deploy:
 	./scripts/deployment/deploy_fly.sh
 
+# deploy to fly.io with demo profile (enables demo metric batches)
+fly-deploy-demo:
+	./scripts/deployment/deploy_fly.sh --profile demo
+
+# deploy to fly.io with production profile (production-ready settings)
+fly-deploy-production:
+	./scripts/deployment/deploy_fly.sh --profile production
+
+# deploy to fly.io with development profile (all examples enabled)
+fly-deploy-development:
+	./scripts/deployment/deploy_fly.sh --profile development
+
 # check fly.io app status (requires app name as FLY_APP env var)
 fly-status:
 	@if [ -z "$$FLY_APP" ]; then echo "Set FLY_APP environment variable"; exit 1; fi

docs/docs/deployment/docker.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 4
 ---
 
 # Docker Deployment

docs/docs/deployment/fly.md

@@ -175,6 +175,26 @@ After deployment completes:
 - **📊 Dashboard**: `https://your-app-name.fly.dev/`
 - **🔐 Admin UI**: `https://your-app-name.fly.dev/dagster` (credentials shown after deploy)
 
+## Deployment Profiles
+
+Anomstack supports **deployment profiles** that act like "Helm values files", allowing you to configure different environments (demo, production, development) without modifying the original metric batch examples.
+
+:::tip Learn More
+📋 **[See the complete Deployment Profiles guide](profiles.md)** for detailed instructions on using profiles for environment-specific configurations.
+:::
+
+**Quick examples:**
+```bash
+# Deploy demo instance (enables key examples)
+make fly-deploy-demo
+
+# Deploy production instance (clean, focused)  
+make fly-deploy-production
+
+# Preview before deploying
+make fly-preview-demo
+```
+
 ## Manual Deployment
 
 For more control over the deployment process:

docs/docs/deployment/gcp.md

@@ -1,4 +1,8 @@
-# Goolge Cloud Platform
+---
+sidebar_position: 5
+---
+
+# Google Cloud Platform
 
 ## Deploying to a VM
 

docs/docs/deployment/overview.md

@@ -136,6 +136,14 @@ Scalable options for production workloads.
 | **Kubernetes** | Multi-node, enterprise scale |
 | **Docker Swarm** | Simple orchestration |
 
+### Configuration Management
+
+| Feature | Description | Compatibility |
+|---------|-------------|---------------|
+| **[Deployment Profiles](profiles.md)** | Environment-specific configurations (demo, production, dev) | Fly.io, Docker, Custom |
+| **[Environment Variables](../configuration/environment-variables.md)** | Runtime configuration overrides | All platforms |
+| **[Hot Reload](../configuration/hot-reload.md)** | Dynamic configuration updates | Docker, Local |
+
 ## Architecture Patterns
 
 ### Pattern 1: All-in-One (Recommended for Getting Started)
@@ -271,7 +279,8 @@ ANOMSTACK_ALERT_WEBHOOK_URL=https://api.company.com/alerts
 ### Deployment Guides
 
 - **[Docker Deployment](docker.md)** - Self-hosted with Docker Compose
-- **[Fly.io Deployment](fly.md)** - Global edge deployment with managed infrastructure  
+- **[Fly.io Deployment](fly.md)** - Global edge deployment with managed infrastructure
+- **[Deployment Profiles](profiles.md)** - Environment-specific configurations (demo, production, dev)  
 - **[Google Cloud Deployment](gcp.md)** - GCP-native integration
 - **[Storage Optimization](storage-optimization.md)** - Optimize storage for large deployments