Added the module feature

Signed-off-by: vviveksharma <visharma@progress.com>

Author: vviveksharma

.github/dependabot.yml

@@ -8,9 +8,6 @@ updates:
       interval: "weekly"
       day: "monday"
     open-pull-requests-limit: 5
-    labels:
-      - "dependencies"
-      - "github-actions"
 
   # Go modules
   - package-ecosystem: "gomod"
@@ -19,9 +16,6 @@ updates:
       interval: "weekly"
       day: "monday"
     open-pull-requests-limit: 5
-    labels:
-      - "dependencies"
-      - "go"
     groups:
       # Group all patch and minor updates together
       minor-patch:

.github/workflows/test.yml

@@ -35,7 +35,7 @@ jobs:
       run: go test -v -race -coverprofile=coverage.out -covermode=atomic ./...
 
     - name: Upload coverage to Codecov
-      uses: codecov/codecov-action@v4
+      uses: codecov/codecov-action@v6
       if: matrix.os == 'ubuntu-latest'
       with:
         files: ./coverage.out

README.md

@@ -23,30 +23,47 @@ go build -o goforge ./cmd/goforge
 sudo mv goforge /usr/local/bin/
 ```
 
-## 📖 Usage
+## 📖 Quick Start
 
-Create a new project with your choice of web framework:
+### Basic Usage
+
+Create a new project in seconds:
 
 ```bash
-# Using Fiber (high performance)
-goforge create my-awesome-api --server fiber
-# or shorthand
-goforge create my-awesome-api -s fiber
-
-# Using Gin (popular, feature-rich)
-goforge create my-awesome-api --server gin
-# or shorthand
-goforge create my-awesome-api -s gin
+# Create with Fiber (high performance)
+goforge create my-api -s fiber
+
+# Create with Gin (feature-rich)
+goforge create my-api -s gin
 ```
 
-Then start developing:
+### Custom Module Path (Optional)
+
+By default, your Go module will be named after your project (e.g., `module my-api`).
+
+If you want a custom module path for GitHub/GitLab or organization projects:
 
 ```bash
-cd my-awesome-api
+# With custom module path
+goforge create my-api -s fiber --module github.com/yourusername/my-api
+
+# Short form
+goforge create my-api -s fiber -m github.com/viveksharma/my-api
+```
+
+### Start Developing
+
+```bash
+cd my-api
 make up
 ```
 
-Visit `http://localhost:8080/health/ready` to verify the API is running.
+Your API is now running at `http://localhost:8080` 🚀
+
+**Quick health check:**
+```bash
+curl http://localhost:8080/health/ready
+```
 
 ## ✨ What You Get
 
@@ -214,57 +231,127 @@ Add your tests in:
 
 ## 📖 Examples
 
-### Create a Fiber-based API (default)
+### Simple Project (Local Development)
+
+For quick prototyping or local projects, use the simple syntax:
 
 ```bash
-goforge create my-fiber-api
-# or explicitly: goforge create my-fiber-api --server fiber
+goforge create my-api -s fiber
+# Result: go.mod → module my-api
 ```
 
-### Create a Gin-based API
+### GitHub/GitLab Project
+
+For projects you'll push to GitHub or GitLab, specify the full module path:
 
 ```bash
-goforge create my-gin-api --server gin
+goforge create my-api -s fiber -m github.com/yourusername/my-api
+# Result: go.mod → module github.com/yourusername/my-api
 ```
 
-### What happens:
+### Organization/Company Project
+
+For company or organization projects:
+
+```bash
+goforge create payment-service -s gin -m gitlab.company.com/backend/payment-service
+# Result: go.mod → module gitlab.company.com/backend/payment-service
+```
+
+### What Happens When You Create a Project
 
 1. ✅ Creates project directory
-2. ✅ Generates all project files
-3. ✅ Sets up your chosen web framework (Fiber or Gin)
-4. ✅ Configures PostgreSQL and Redis
-5. ✅ Adds health check endpoints
-6. ✅ Sets up database migrations
-7. ✅ Generates Swagger/OpenAPI docs
-8. ✅ Adds Prometheus metrics endpoint
-9. ✅ Includes Docker Compose
-10. ✅ Creates comprehensive README
-11. ✅ Runs `go mod tidy` automatically
-
-### Start developing immediately
+2. ✅ Generates all project files with your chosen framework
+3. ✅ Sets up PostgreSQL database with connection pooling
+4. ✅ Configures Redis for caching
+5. ✅ Adds health check endpoints (`/health/live`, `/health/ready`)
+6. ✅ Sets up database migrations system
+7. ✅ Generates Swagger/OpenAPI docs at `/swagger/index.html`
+8. ✅ Adds Prometheus metrics at `/metrics`
+9. ✅ Includes Docker Compose for one-command startup
+10. ✅ Creates comprehensive README with all commands
+11. ✅ Downloads dependencies automatically
+
+### Start Coding Immediately
 
 ```bash
-cd my-fiber-api  # or my-gin-api
-make up
+cd my-api
+make up        # Starts PostgreSQL, Redis, and your API
+make logs      # Watch the logs
+
+# Test your API
 curl http://localhost:8080/health/ready
+curl http://localhost:8080/metrics
+
+# View API docs
+open http://localhost:8080/swagger/index.html
 ```
 
 ## 🔀 Choosing a Framework
 
 ### Use Fiber when:
-- You need maximum performance and minimal memory footprint
-- You prefer Express.js-like syntax and patterns
-- Your application handles high concurrent loads
-- You want the fastest request/response times
+- 🚀 You need **maximum performance** and minimal memory footprint
+- 💚 You prefer **Express.js-like** syntax and patterns
+- ⚡ Your application handles **high concurrent loads**
+- 🏎️ You want the **fastest** request/response times
 
 ### Use Gin when:
-- You prefer a mature, battle-tested framework
-- You need extensive middleware ecosystem
-- You want built-in validation and binding
-- Your team is already familiar with Gin
+- 🛡️ You prefer a **mature, battle-tested** framework
+- 🔧 You need **extensive middleware** ecosystem
+- ✅ You want **built-in validation** and binding
+- 👥 Your team is **already familiar** with Gin
 
 **Both frameworks generate identical project structure and features** - the only difference is the web framework implementation.
 
+## 🎯 Module Path Guide
+
+### When to Use Default (No `--module` flag)
+
+```bash
+goforge create my-project -s fiber
+```
+
+✅ **Perfect for:**
+- Quick prototypes and experiments
+- Learning projects
+- Local-only development
+- Tools and scripts that won't be shared
+
+**Result:** `module my-project` (simple and clean)
+
+### When to Use Custom Module Path
+
+```bash
+goforge create my-project -s fiber -m github.com/username/my-project
+```
+
+✅ **Perfect for:**
+- Projects you'll push to GitHub/GitLab
+- Open source projects
+- Company/organization codebases
+- Projects with internal imports
+
+**Result:** `module github.com/username/my-project`
+
+### Module Path Examples
+
+```bash
+# GitHub
+goforge create api -s fiber -m github.com/viveksharma/api
+
+# GitLab
+goforge create service -s gin -m gitlab.com/myorg/service
+
+# Self-hosted GitLab
+goforge create payment -s fiber -m git.company.com/backend/payment
+
+# Bitbucket
+goforge create auth -s gin -m bitbucket.org/team/auth
+
+# Company domain
+goforge create users -s fiber -m go.company.com/services/users
+```
+
 ## 🤝 Contributing
 
 Contributions welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

go.mod

@@ -3,14 +3,14 @@ module github.com/viveksharma/goforge
 go 1.26.2
 
 require (
-	github.com/spf13/cobra v1.8.0
-	github.com/stretchr/testify v1.9.0
+	github.com/spf13/cobra v1.10.2
+	github.com/stretchr/testify v1.11.1
 )
 
 require (
 	github.com/davecgh/go-spew v1.1.1 // indirect
 	github.com/inconshreveable/mousetrap v1.1.0 // indirect
 	github.com/pmezard/go-difflib v1.0.0 // indirect
-	github.com/spf13/pflag v1.0.5 // indirect
+	github.com/spf13/pflag v1.0.10 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
 )

go.sum

@@ -1,17 +1,19 @@
-github.com/cpuguy83/go-md2man/v2 v2.0.3/go.mod h1:tgQtvFlXSQOSOSIRvRPT7W67SCa46tRHOmNcaadrF8o=
+github.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8=
 github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw=
 github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
 github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
-github.com/spf13/cobra v1.8.0 h1:7aJaZx1B85qltLMc546zn58BxxfZdR/W22ej9CFoEf0=
-github.com/spf13/cobra v1.8.0/go.mod h1:WXLWApfZ71AjXPya3WOlMsY9yMs7YeiHhFVlvLyhcho=
-github.com/spf13/pflag v1.0.5 h1:iy+VFUOCP1a+8yFto/drg2CJ5u0yRoB7fZw3DKv/JXA=
-github.com/spf13/pflag v1.0.5/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
-github.com/stretchr/testify v1.9.0 h1:HtqpIVDClZ4nwg75+f6Lvsy/wHu+3BoSGCbBAcpTsTg=
-github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
+github.com/spf13/cobra v1.10.2 h1:DMTTonx5m65Ic0GOoRY2c16WCbHxOOw6xxezuLaBpcU=
+github.com/spf13/cobra v1.10.2/go.mod h1:7C1pvHqHw5A4vrJfjNwvOdzYu0Gml16OCs2GRiTUUS4=
+github.com/spf13/pflag v1.0.9/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
+github.com/spf13/pflag v1.0.10 h1:4EBh2KAYBwaONj6b2Ye1GiHfwjqyROoF4RwYO+vPwFk=
+github.com/spf13/pflag v1.0.10/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
+github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
+github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
+go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=

internal/cmd/create.go

@@ -15,6 +15,7 @@ import (
 
 var (
 	serverType string
+	modulePath string
 )
 
 // CreateOptions contains dependencies for the create command.
@@ -35,6 +36,7 @@ var createCmd = &cobra.Command{
 
 func init() {
 	createCmd.Flags().StringVarP(&serverType, "server", "s", "", "Web framework to use (fiber or gin) [REQUIRED]")
+	createCmd.Flags().StringVarP(&modulePath, "module", "m", "", "Go module path (e.g., github.com/user/project). Defaults to project name")
 	if err := createCmd.MarkFlagRequired("server"); err != nil {
 		panic(fmt.Sprintf("failed to mark server flag as required: %v", err))
 	}
@@ -89,10 +91,16 @@ func runCreateWithDeps(opts CreateOptions, cmd *cobra.Command, args []string) er
 	opts.Writer.Printf("📦 Server framework: %s\n", serverType)
 
 	// Generate project
+	// Use custom module path if provided, otherwise default to project name
+	modPath := modulePath
+	if modPath == "" {
+		modPath = projectName
+	}
+
 	config := generator.ProjectConfig{
 		ProjectName: projectName,
 		ProjectPath: projectPath,
-		ModulePath:  fmt.Sprintf("github.com/yourusername/%s", projectName),
+		ModulePath:  modPath,
 		ServerType:  serverType,
 	}
 

internal/generator/templates/Makefile.tmpl

@@ -7,14 +7,14 @@ help: ## Show this help message
 	@awk 'BEGIN {FS = ":.*?## "} /^[a-zA-Z_-]+:.*?## / {printf "  %-15s %s\n", $$1, $$2}' $(MAKEFILE_LIST)
 
 up: ## Start all services (API, PostgreSQL, Redis)
-	docker-compose up -d
+	docker compose up -d
 	@echo "✅ Services started. API: http://localhost:8080"
 
 down: ## Stop all services
-	docker-compose down
+	docker compose down
 
 logs: ## View logs from all services
-	docker-compose logs -f
+	docker compose logs -f
 
 build: ## Build the Go binary
 	go build -o bin/{{.ProjectName}} cmd/api/main.go
@@ -38,10 +38,10 @@ clean: ## Clean up build artifacts and stop services
 	rm -f coverage.out
 
 db-connect: ## Connect to PostgreSQL database
-	docker-compose exec postgres psql -U {{.ProjectName}}_user -d {{.ProjectName}}_db
+	docker compose exec postgres psql -U {{.ProjectName}}_user -d {{.ProjectName}}_db
 
 redis-cli: ## Connect to Redis CLI
-	docker-compose exec redis redis-cli
+	docker compose exec redis redis-cli
 
 migrate-up: ## Run all pending migrations
 	@echo "Running migrations..."

internal/generator/templates/README.md.tmpl

@@ -263,7 +263,7 @@ make up
 **Redis connection failed:**
 ```bash
 # Check Redis logs
-docker-compose logs redis
+docker compose logs redis
 ```
 
 ## 📄 License

internal/generator/templates/cmd/api/main.go.tmpl

@@ -12,7 +12,6 @@ import (
 
 	"{{.ModulePath}}/internal/config"
 	"{{.ModulePath}}/internal/server"
-	"{{.ModulePath}}/pkg/database"
 	"{{.ModulePath}}/pkg/logger"
 	"{{.ModulePath}}/pkg/migration"
 )

internal/generator/templates/deployments/Dockerfile.tmpl

@@ -19,9 +19,10 @@ COPY . .
 # Build binary with security flags
 # -trimpath: removes file system paths from the binary
 # -ldflags "-s -w": strip debug information (smaller binary)
-RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build \
+RUN VERSION=$(git describe --tags --always --dirty 2>/dev/null || echo "dev") && \
+    CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build \
     -trimpath \
-    -ldflags="-s -w -X main.version=$(git describe --tags --always --dirty)" \
+    -ldflags="-s -w -X main.version=${VERSION}" \
     -o api \
     cmd/api/main.go