Welcome to CraftGo!

[harry-2401]

🚀 craftgo is here — write the spec, generate everything

Welcome to the craftgo community! Whether you found us through the docs, a link, or pure curiosity — glad you're here.

craftgo is a design-first framework for Go HTTP services. You describe your API once in a small DSL — types, validators, endpoints, errors — and craftgo gen produces the typed structs, request validation, HTTP handlers, route wiring, and an OpenAPI 3.1 spec. The generated code is plain
net/http: no custom router, no reflection, no runtime struct tags. It reads like code you'd have written by hand.

Why we built it

Hand-written Go services drift: the handler, the validation, the docs, and the OpenAPI spec all describe the same endpoint, but they live in four places and fall out of sync the moment someone's in a hurry. Most design-first tools fix that by locking you into a heavy framework with its own
router and runtime.

craftgo takes the other path — the spec is the single source of truth, and the output is just standard library. Change the DSL, regenerate, and your types, validators, routes, and spec all move together. No framework in the hot path to learn or fight.

A 30-second taste

package design

type CreateUserReq {
    name  string @length(1, 80)
    email string @format(email)
    age   int?   @gte(0) @lte(150)
}

@prefix("/v1")
service UserService {
    post CreateUser /users {
        request  CreateUserReq
        response User
    }
}

craftgo gen writes the handler, the Validate() method, the route, and docs/openapi.yaml. You fill one logic stub — everything else regenerates.

What you get

• 🎯 One source of truth — types, validators, handlers, routes, and the OpenAPI spec from the same .craftgo files.
• 🔌 Plain net/http — handlers are http.HandlerFunc on *http.ServeMux; middleware is func(http.Handler) http.Handler.
• ✅ Declarative validation compiled to plain Go if statements — no reflection, no runtime tags.
• 📜 OpenAPI 3.1 emitted from the same source; renders in Swagger UI and ReDoc.
• 🧰 Rich types — scalars with inherited validators, enums, generics, cross-package composition, mixins, typed errors.
• 🛠 First-class tooling — an LSP (completion, hover, go-to-definition, live diagnostics) and a VS Code extension.

Try it

go install github.com/craftgodotdev/craftgo/cmd/craftgo@latest

• 📖 Docs: https://craftgodotdev.github.io/craftgo
• 🏁 Getting Started: https://craftgodotdev.github.io/craftgo/guide/getting-started
• 🤖 Drafting with an LLM? Paste https://craftgodotdev.github.io/craftgo/llms into your prompt — it's a single-page reference so your assistant knows the real DSL.

Where we are

craftgo is pre-1.0. The DSL and generated layout are stabilizing toward 1.0; expect the occasional breaking change until then, always called out in the changelog. This is exactly the moment your feedback shapes the design the most.

Get involved

• 💬 Questions / show & tell — right here in Discussions.
• 🐞 Bugs & feature ideas — open an issue.
• 🤝 Want to contribute? See CONTRIBUTING.md.