FiberForge (fiberforge) is a high-performance Go CLI and MCP server that generates complete, production-grade Go Fiber (v2) REST API backends from a declarative YAML or JSON schema.
Give it a schema describing your domain entities and features, and FiberForge scaffolds clean, deterministic code: GORM/MGM database models, business logic services, Fiber controllers, JWT authentication, versioned SQL migrations, Swagger docs, Docker containerization, structured log/slog logging, graceful shutdown, health probes, and unit tests.
Design Principle: AI agents write the schema; FiberForge renders deterministic, 100% compilable, production-ready Go code in 50 milliseconds.
- Databases: PostgreSQL, MySQL, MongoDB (GORM for SQL,
mgmfor Mongo). - Framework: Go Fiber (v2) with Go 1.23+ generated code.
- Opt-in Features:
auth(JWT),docker,migrations,swagger,rateLimit,cors,logging,testing,ci. - Relationships: First-class support for
belongsTo,hasMany, andmanyToManygraph relations with foreign key indices and migration join tables. - Production-Grade Infrastructure:
- Structured JSON logging (
log/slog) with request ID correlation. - Graceful shutdown (
signal.NotifyContext+app.ShutdownWithTimeout). - Kubernetes/Cloud probes:
/health/liveand/health/ready(with DB ping). - Configurable database connection pooling.
- Docker Compose with container healthchecks.
- GitHub Actions CI workflow with
golangci-lintand race-detector testing.
- Structured JSON logging (
- Dual Mode (Single Binary):
- CLI mode (
fiberforge scaffold,fiberforge init,--dry-run). - Agentic MCP server (
fiberforge serve) exposing 5 tools over stdio JSON-RPC 2.0.
- CLI mode (
You don't even need Go installed to use FiberForge. Just run it via npx:
npx fiberforge-cli initgo install github.com/v-pat/fiberforge@latestgit clone https://github.com/v-pat/fiberforge.git
cd fiberforge
go build -o fiberforge .Launch an interactive terminal UI powered by Charm's huh to configure your app, pick features, and build models visually:
fiberforge initGenerates a fiberforge.yaml schema and offers to scaffold immediately.
Scaffold a project deterministically from a schema file:
fiberforge scaffold examples/blog.yaml
fiberforge scaffold examples/ecommerce.yaml --output-dir /tmp/my-storePreview generated files without touching disk:
fiberforge scaffold examples/blog.yaml --dry-runRun FiberForge as a Model Context Protocol (MCP) server over stdio for AI coding agents (Claude Code, Cursor, Cline, Windsurf, opencode):
fiberforge serveAdd FiberForge to your editor's MCP config:
Cursor (.cursor/mcp.json) / Claude Code (mcp.json):
{
"mcpServers": {
"fiberforge": {
"command": "npx",
"args": ["-y", "fiberforge-cli", "serve"]
}
}
}(If you installed via Go, you can use "command": "fiberforge", "args": ["serve"] instead)
opencode (.opencode.json):
{
"mcp": {
"fiberforge": {
"type": "local",
"command": ["npx", "-y", "fiberforge-cli", "serve"]
}
}
}Want your AI coding assistant (Cursor, Antigravity, Claude Code) to automatically use FiberForge whenever you ask for a Go backend?
- Cursor: Copy
.cursor/rules/fiberforge.mdcinto your project's.cursor/rules/directory. - Antigravity / General Agents: Import
skills/fiberforge/SKILL.mdinto your skills library.
When active, your AI agent will design the schema and invoke npx fiberforge-cli scaffold or generate_project in 50ms instead of generating Go code manually line-by-line!
| Tool | Description |
|---|---|
generate_project |
Generate a complete, compilable Go Fiber project from a YAML/JSON schema string. |
validate_schema |
Validate a schema string without generating files, reporting any semantic problems. |
get_schema_template |
Fetch a pre-built starter schema (blog, ecommerce, saas, social) to customize. |
list_field_types |
List all supported field types, options, database drivers, and relationship kinds. |
explain_project |
Dry-run a schema to inspect the exact file tree, models, and endpoints it produces. |
YAML is primary; JSON is also supported.
appName: blog
framework: fiber # optional, defaults to fiber
database: postgres # postgres | mysql | mongodb
port: 8080 # optional, defaults to 8080
env: # optional custom environment variables
STRIPE_KEY: sk_test_123
features:
auth: true # JWT authentication (auto User model, /register, /login, /me, /refresh)
docker: true # Multi-stage Dockerfile + docker-compose with healthchecks
migrations: true # Versioned SQL migrations (.up.sql / .down.sql) + Makefile runner
swagger: true # OpenAPI 3.0 specification (docs/swagger.json)
rateLimit: true # Sliding-window rate limiter middleware
cors: true # Configurable CORS middleware
logging: true # Fiber request logger middleware
testing: true # Controller & Auth smoke tests
ci: true # GitHub Actions CI workflow (golangci-lint + test -race)
models:
- name: user
endpoint: users
auth: true # protect this model's routes with JWT middleware
tableName: account_users # optional explicit table/collection override
fields:
- name: email
type: string
required: true
unique: true
validation: email
- name: password
type: password
required: true
sensitive: true # never serialized in JSON (json:"-")
- name: role
type: enum
values: [admin, member, guest]
- name: post
endpoint: posts
fields:
- name: title
type: string
required: true
- name: content
type: text
- name: views
type: int
default: "0"
relationships:
- type: belongsTo
model: user
- type: manyToMany
model: tag
- name: tag
endpoint: tags
fields:
- name: name
type: string
required: true
unique: truestring, text, int, int64, float, bool, time, uuid, json, enum (with values), password (bcrypt hashed).
required, unique, default, validation, sensitive, index, jsonTag, omitempty, values.
belongsTo: Injects foreign key (<Model>ID) + association field (<Model>).hasMany: Injects association slice ([]<Model>).manyToMany: Injects association slice ([]<Model>) + generates SQL join table migration (<self>_<target>).
Explore real-world starter schemas in the examples/ directory:
examples/blog.yaml: Publishing platform with authors, posts, tags, JWT auth, PostgreSQL, and Swagger.examples/ecommerce.yaml: E-commerce catalog with products, categories, orders, PostgreSQL, and rate limiting.examples/saas.yaml: Multi-tenant SaaS structure with organizations, subscriptions, PostgreSQL, and CORS.examples/social.yaml: Social feed with posts, comments, MongoDB, and rate limiting.
blog/
├── go.mod / README.md / .gitignore / .env.example
├── main.go # App bootstrap (slog, requestid, graceful shutdown)
├── config/config.go # Env loader with dynamic defaults
├── databases/db.go # Database connection, pooling, AutoMigrate & Ping()
├── model/*.go # GORM / mgm struct definitions with tags
├── service/*.go # Business logic CRUD handlers
├── controller/*.go # HTTP handlers with request validation
├── routes/routes.go # Route registration & health probes (/health/live, /health/ready)
├── auth/ # JWT token creation, password hashing, user store (when auth: true)
├── middleware/jwt.go # Fiber JWT authentication middleware (when auth: true)
├── migrations/ # Up & down SQL migration scripts (when migrations: true)
├── docs/swagger.json # OpenAPI 3.0 document (when swagger: true)
├── Dockerfile, docker-compose.yml, Makefile
└── .github/workflows/ci.yml # GitHub Actions workflow
Run all unit tests (schema validation, engine code generation, MCP protocol):
go test ./...MIT License. See LICENSE for details.