Update configuration examples to match common use cases

Author: gtsiolis

README.md

@@ -93,36 +93,43 @@ lstk --config /path/to/lstk.toml start
 
 ```toml
 [[containers]]
-type = "aws"
-tag  = "latest"
-port = "4566"
+type = "aws"     # Emulator type. Currently supported: "aws"
+tag  = "latest"  # Docker image tag, e.g. "latest", "2026.03"
+port = "4566"    # Host port the emulator will be accessible on
+# volume = ""    # Host directory for persistent state (default: OS cache dir)
+# env = []       # Named environment profiles to apply (see [env.*] sections below)
 ```
 
 **Fields:**
 - `type`: emulator type; only `"aws"` is supported for now
 - `tag`: Docker image tag for LocalStack (e.g. `"latest"`, `"4.14.0"`); useful for pinning a version
 - `port`: port LocalStack listens on (default `4566`)
+- `volume`: (optional) host directory for persistent emulator state (default: OS cache dir)
 - `env`: (optional) list of named environment variable groups to inject into the container (see below)
 
 ### Passing environment variables to the container
 
-Define reusable named env sets and reference them per container:
+Define reusable named env profiles and reference them per container. Profiles are merged, so you can mix and match:
 
 ```toml
 [[containers]]
 type = "aws"
-tag  = "4.14.0"
+tag  = "latest"
 port = "4566"
-env  = ["prod", "debug"]
-
-[env.prod]
-LOCALSTACK_HOST = "localstack.cloud"
+env  = ["debug", "ci"]
 
 [env.debug]
-LS_LOG = "trace"
-DEBUG  = "1"
+DEBUG = "1"
+ENFORCE_IAM = "1"
+PERSISTENCE = "1"
+
+[env.ci]
+SERVICES = "s3,sqs"
+EAGER_SERVICE_LOADING = "1"
 ```
 
+Then run `lstk start` - the profiles are automatically applied to the container.
+
 ## Interactive And Non-Interactive Mode
 
 `lstk` uses the TUI in an interactive terminal and plain output elsewhere. Use `--non-interactive` to force plain output even in a TTY:

internal/config/default_config.toml

@@ -13,22 +13,24 @@ port = "4566"    # Host port the emulator will be accessible on
 # Environment profiles let you group environment variables and reference
 # them by name in one or more containers via the 'env' field above.
 #
-# Example variables based on commonly used current config options:
+# Example variables based on most used options:
 #
-#   DEBUG=1          - Enable verbose logging
-#   PERSISTENCE=1    - Persist LocalStack state across restarts
-#   ENFORCE_IAM=1    - Enable IAM enforcement
+#   DEBUG=1                 - Enable verbose logging
+#   PERSISTENCE=1           - Persist LocalStack state across restarts
+#   ENFORCE_IAM=1           - Enable IAM policy enforcement
+#   SERVICES=s3,sqs         - Limit services to load (faster startup)
+#   EAGER_SERVICE_LOADING=1 - Start services at startup (good for CI)
 #
 # See full list of configuration options:
 # > https://docs.localstack.cloud/references/configuration/
 #
-# Example:
+# Example profiles:
 #
 # [env.debug]
 # DEBUG = "1"
-#
-# [env.persist]
 # PERSISTENCE = "1"
-#
-# [env.security]
 # ENFORCE_IAM = "1"
+#
+# [env.ci]
+# SERVICES = "s3,sqs"
+# EAGER_SERVICE_LOADING = "1"