chore(dependencies): update forgeui dependency and enhance README documentation

- Updated the `github.com/xraph/forgeui` dependency from v0.0.4 to v0.0.8 in `go.mod` and `go.sum` to ensure compatibility with the latest features and improvements.
- Enhanced the README documentation for the Forge CLI, adding example configurations and a migration guide to simplify the transition from verbose to minimal configuration.
- Improved clarity on configuration defaults and provided a structured overview of key configuration sections.

Signed-off-by: Rex Raphael <rex.raphael@outlook.com>

Author: juicycleff

app_impl.go

@@ -252,18 +252,29 @@ func newApp(config AppConfig) *app {
 	// Register core services with DI - Both key-based (legacy) and type-based (new pattern)
 
 	// Key-based registration (backward compatibility)
+	// Register with both the full keys and simple keys for vessel compatibility
 	_ = RegisterSingleton(container, shared.LoggerKey, func(c Container) (Logger, error) {
 		return logger, nil
 	})
+	_ = RegisterSingleton(container, "logger", func(c Container) (Logger, error) {
+		return logger, nil
+	}) // Simple key for vessel.GetLogger
+
 	_ = RegisterSingleton(container, shared.ConfigKey, func(c Container) (ConfigManager, error) {
 		return configManager, nil
 	})
+
 	_ = RegisterSingleton(container, shared.MetricsKey, func(c Container) (Metrics, error) {
 		return metrics, nil
 	})
+	_ = RegisterSingleton(container, "metrics", func(c Container) (Metrics, error) {
+		return metrics, nil
+	}) // Simple key for vessel.GetMetrics
+
 	_ = RegisterSingleton(container, shared.HealthManagerKey, func(c Container) (HealthManager, error) {
 		return healthManager, nil
 	})
+
 	_ = RegisterSingleton(container, shared.RouterKey, func(c Container) (Router, error) {
 		return router, nil
 	})

cmd/forge/README.md

@@ -238,9 +238,51 @@ forge ext info -n database
 
 The `.forge.yaml` file configures your Forge project. It's automatically searched up the directory tree, so you can run `forge` commands from any subdirectory.
 
-See example configurations:
-- [single-module.forge.yaml](./examples/single-module.forge.yaml)
-- [multi-module.forge.yaml](./examples/multi-module.forge.yaml)
+**Forge uses convention over configuration** - most projects only need a minimal config file. Smart defaults handle the rest!
+
+#### Example Configurations
+
+- **[minimal.forge.yaml](./examples/minimal.forge.yaml)** - Minimal config (recommended for most projects)
+- **[typical.forge.yaml](./examples/typical.forge.yaml)** - Common customizations
+- **[single-module.forge.yaml](./examples/single-module.forge.yaml)** - Full single-module example
+- **[multi-module.forge.yaml](./examples/multi-module.forge.yaml)** - Full multi-module example
+
+#### Minimal Configuration (Recommended)
+
+Most projects only need this:
+
+```yaml
+project:
+  name: "my-project"
+  module: "github.com/myorg/my-project"
+
+database:
+  driver: "postgres"
+  connections:
+    dev:
+      url: "postgres://localhost:5432/mydb_dev?sslmode=disable"
+    production:
+      url: "${DATABASE_URL}"
+```
+
+**That's it!** Everything else uses smart defaults:
+- Project structure: Go conventions (`cmd/`, `apps/`, `pkg/`, `internal/`)
+- Build: Auto-discovers apps in `cmd/`
+- Dev: Auto-discovers and watches Go files
+- Migrations: `./database/migrations`
+- Output: `./bin`
+
+### Configuration by Convention
+
+Forge follows Go conventions and provides sensible defaults:
+
+| Setting | Default | Override When |
+|---------|---------|---------------|
+| `cmd/` directory | `./cmd` | Non-standard layout |
+| `apps/` directory | `./apps` | Non-standard layout |
+| Build output | `./bin` | Custom output location |
+| Migrations path | `./database/migrations` | Custom location |
+| Auto-discovery | Enabled | Need explicit control |
 
 ### Key Configuration Sections
 
@@ -316,6 +358,69 @@ extensions:
     jwt_secret: "${JWT_SECRET}"
 ```
 
+## Migration Guide
+
+### Migrating from Verbose to Minimal Config
+
+If you have an existing verbose `.forge.yaml`, you can simplify it:
+
+**Before (verbose):**
+```yaml
+project:
+  name: "my-project"
+  module: "github.com/myorg/my-project"
+  layout: "single-module"
+  structure:
+    cmd: "./cmd"
+    apps: "./apps"
+    pkg: "./pkg"
+    internal: "./internal"
+
+dev:
+  auto_discover: true
+  watch:
+    enabled: true
+    paths:
+      - "./apps/**/*.go"
+      - "./pkg/**/*.go"
+
+database:
+  driver: "postgres"
+  migrations_path: "./database/migrations"
+  seeds_path: "./database/seeds"
+
+build:
+  output_dir: "./bin"
+  auto_discover: true
+```
+
+**After (minimal):**
+```yaml
+project:
+  name: "my-project"
+  module: "github.com/myorg/my-project"
+
+database:
+  driver: "postgres"
+  connections:
+    dev:
+      url: "postgres://localhost:5432/mydb_dev"
+```
+
+**What changed:**
+- Removed `structure` - uses Go conventions
+- Removed `dev.watch.paths` - auto-discovers Go files
+- Removed `build.output_dir` - defaults to `./bin`
+- Removed `migrations_path` - defaults to `./database/migrations`
+- All fields with default values can be omitted
+
+**Breaking Changes in v2.x:**
+- `database.codegen` removed (never implemented - use sqlc, gorm-gen, or sqlboiler)
+- `project.structure` is now optional (nil = use conventions)
+- Build auto-discovery is now default
+
+Your existing verbose configs will continue to work, but you can gradually simplify them.
+
 ## Plugin System
 
 Forge CLI is built on a plugin architecture. Current plugins:

cmd/forge/config/loader.go

@@ -73,15 +73,24 @@ func tryLoadConfig(path string) (*ForgeConfig, error) {
 }
 
 // SaveForgeConfig saves the configuration to a file.
+// Uses omitempty tags to produce clean, minimal YAML output.
 func SaveForgeConfig(config *ForgeConfig, path string) error {
-	// Marshal to YAML
+	// Marshal to YAML with proper formatting
 	data, err := yaml.Marshal(config)
 	if err != nil {
 		return fmt.Errorf("failed to marshal config: %w", err)
 	}
 
+	// Add header comment
+	header := `# Forge Configuration
+# This file uses smart defaults - only specify what you need to override.
+# See https://forge.dev/docs/configuration for full documentation.
+
+`
+	finalData := []byte(header + string(data))
+
 	// Write to file
-	if err := os.WriteFile(path, data, 0644); err != nil {
+	if err := os.WriteFile(path, finalData, 0644); err != nil {
 		return fmt.Errorf("failed to write config file: %w", err)
 	}