Update to readme

Author: greysquirr3l

CHANGELOG.md

@@ -23,19 +23,22 @@ This release brings **first-class array support** to the GORM DuckDB driver, mak
 ### 🔧 Technical Implementation
 
 #### Array Type System
+
 ```go
 type StringArray []string  // Maps to TEXT[]
 type IntArray []int64      // Maps to BIGINT[]  
 type FloatArray []float64  // Maps to DOUBLE[]
 ```
 
 #### GORM Integration
+
 - Automatic schema migration with proper array column types
 - Full CRUD support (Create, Read, Update, Delete) for array fields
 - Type-safe operations with compile-time checking
 - Seamless marshaling/unmarshaling between Go and DuckDB array syntax
 
 #### Database Features
+
 - **Array Literals**: Automatic conversion to DuckDB format `['a', 'b', 'c']`
 - **Null Handling**: Proper nil array support
 - **Empty Arrays**: Correct handling of zero-length arrays
@@ -44,7 +47,8 @@ type FloatArray []float64  // Maps to DOUBLE[]
 
 ### 🎯 Usage Examples
 
-#### Model Definition
+#### Model 
+
 ```go
 type Product struct {
     ID         uint                `gorm:"primaryKey"`
@@ -56,6 +60,7 @@ type Product struct {
 ```
 
 #### Array Operations
+
 ```go
 // Create with arrays
 product := Product{
@@ -208,6 +213,7 @@ This ensures that **all** database operations, including those within transactio
 ---
 
 **Legend:**
+
 - 🎉 Major Feature
 - ✨ Added
 - 🔧 Technical

README.md

@@ -31,9 +31,35 @@ A comprehensive, production-ready DuckDB driver for [GORM](https://gorm.io), bri
 
 ### Install
 
+**Step 1:** Add the dependencies to your project:
+
 ```bash
-go get -u gorm.io/driver/duckdb
 go get -u gorm.io/gorm
+go get -u github.com/greysquirr3l/gorm-duckdb-driver
+```
+
+**Step 2:** Add a `replace` directive to your `go.mod` file:
+
+```go
+module your-project
+
+go 1.21
+
+require (
+    gorm.io/driver/duckdb v1.0.0
+    gorm.io/gorm v1.25.12
+)
+
+// Replace directive to use this implementation
+replace gorm.io/driver/duckdb => github.com/greysquirr3l/gorm-duckdb-driver v0.2.4
+```
+
+> **📝 Note**: The `replace` directive is necessary because this driver uses the future official module path `gorm.io/driver/duckdb` but is currently hosted at `github.com/greysquirr3l/gorm-duckdb-driver`. This allows for seamless migration once this becomes the official GORM driver.
+
+**Step 3:** Run `go mod tidy` to update dependencies:
+
+```bash
+go mod tidy
 ```
 
 ### Connect to Database
@@ -57,6 +83,20 @@ db, err := gorm.Open(duckdb.New(duckdb.Config{
 }), &gorm.Config{})
 ```
 
+### Alternative: Direct Import (Without Replace)
+
+If you prefer to import directly without the replace directive:
+
+```go
+import (
+  duckdb "github.com/greysquirr3l/gorm-duckdb-driver"
+  "gorm.io/gorm"
+)
+
+// Usage remains the same
+db, err := gorm.Open(duckdb.Open(":memory:"), &gorm.Config{})
+```
+
 ## 🎨 Array Support (New!)
 
 DuckDB's powerful array types are now fully supported with type safety:
@@ -280,7 +320,7 @@ duckdb.EnableDataFormatExtensions(db)   // parquet, csv, json, etc.
 
 ## 🏗️ Architecture
 
-```
+```ascii
 ┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
 │   Your Go App   │───▶│   GORM Driver    │───▶│     DuckDB      │
 │                 │    │                  │    │   (Embedded)    │
@@ -317,7 +357,7 @@ go test -v
 
 ```bash
 cd example
-go run main.go
+go run main.go  # Run directly without building binary
 ```
 
 ## 📄 License
@@ -335,7 +375,3 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 - 🐛 **Issues**: [GitHub Issues](https://github.com/greysquirr3l/gorm-duckdb-driver/issues)
 - 💬 **Discussions**: [GitHub Discussions](https://github.com/greysquirr3l/gorm-duckdb-driver/discussions)
 - 📖 **Documentation**: [pkg.go.dev](https://pkg.go.dev/gorm.io/driver/duckdb)
-
----
-
-**Made with ❤️ for the Go and DuckDB communities**