Code Generation

The Gofasta CLI includes a powerful code generation system that creates files following the project’s layered architecture (controllers → services → repositories → models). Every generated file follows consistent conventions and integrates with the existing project structure.

The Generate Command

All generators are accessed through gofasta generate (or the shorthand gofasta g):

gofasta g <generator> <Name> [field:type ...]

The Name argument is automatically converted to the correct casing for each context: PascalCase for Go types, snake_case for file names and database tables, and camelCase for JSON fields.

Available Generators

Scaffold: The Full Resource Generator

The scaffold command is the most commonly used generator. It creates every layer of a resource and wires it into the project:

gofasta g scaffold Product name:string price:float description:text active:bool

Generated Files

Patched Files

The scaffold command also modifies existing files to integrate the new resource:

After scaffolding, run gofasta wire to regenerate the Wire DI container, then gofasta migrate up to create the database table.

Field Types

Fields are specified as name:type pairs. The type determines the Go type, SQL column type, and GraphQL type:

SQL types are automatically adapted for the database driver configured in config.yaml.

Individual Generators

Model

Generates the model struct and migration files:

gofasta g model Category name:string description:text

Creates:

• app/models/category.model.go
• db/migrations/000007_create_categories.up.sql
• db/migrations/000007_create_categories.down.sql

The model automatically embeds models.BaseModelImpl for standard fields.

Service

Generates the service interface and implementation:

gofasta g service Notification

Creates:

• app/services/interfaces/notification_service.go
• app/services/notification.service.go

The service implementation receives a repository through its constructor.

Controller

Generates an HTTP controller:

gofasta g controller Payment

Creates:

• app/rest/controllers/payment.controller.go

The controller receives a service through its constructor and includes stub CRUD methods.

Repository

Generates the repository interface and GORM implementation:

gofasta g repository Order

Creates:

• app/repositories/interfaces/order_repository.go
• app/repositories/order.repository.go

DTO

Generates request and response data transfer objects:

gofasta g dto Invoice amount:float status:string due_date:time

Creates:

• app/dtos/invoice.dtos.go

Migration

Generates an empty migration pair for custom SQL:

gofasta g migration add_index_to_products

Creates:

• db/migrations/000008_add_index_to_products.up.sql
• db/migrations/000008_add_index_to_products.down.sql

Both files are empty — you write the SQL yourself. This is useful for schema changes that are not a simple table creation.

Route

Generates a route registration file:

gofasta g route Subscription

Creates:

• app/rest/routes/subscription.routes.go

Resolver

Regenerates GraphQL resolver stubs from schema files:

gofasta g resolver

This runs gqlgen to regenerate resolvers. Existing implementations are preserved.

Provider

Generates a Wire dependency injection provider:

gofasta g provider Analytics

Creates:

• app/di/providers/analytics.go

Job

Generates a cron job definition:

gofasta g job CleanupExpiredTokens

Creates:

• app/jobs/cleanup_expired_tokens.job.go

Task

Generates an async task for the queue:

gofasta g task SendWelcomeEmail

Creates:

• app/jobs/send_welcome_email.task.go

Email Template

Generates an HTML email template:

gofasta g email-template order-confirmation

Creates:

• templates/emails/order-confirmation.html

Customizing Generated Code

All generated code is plain Go — there are no runtime dependencies on the generator. After generation, you own the code and can modify it freely.

Common customizations:

• Add validation rules to DTOs using validate struct tags
• Add indexes to models using gorm struct tags
• Add custom repository methods beyond the standard CRUD
• Add business logic to services
• Add custom endpoints to controllers and routes

Workflow Example

A typical workflow for adding a new feature:

# 1. Generate the full resource
gofasta g scaffold Order total:float status:string user_id:uuid
 
# 2. Regenerate Wire DI container
gofasta wire
 
# 3. Run migrations
gofasta migrate up
 
# 4. Customize the generated code
# - Add validation to app/dtos/order.dtos.go
# - Add business logic to app/services/order.service.go
# - Add auth middleware to app/rest/routes/order.routes.go
 
# 5. Test
curl -X POST http://localhost:8080/api/v1/orders \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{"total": 99.99, "status": "pending", "user_id": "..."}'

Next Steps

• Build REST endpoints
• Set up GraphQL resolvers
• Manage database migrations
• CLI scaffold reference

Related