Skip to content

A Go-built compiler for web services

Describe the service. Generate the code.

Blueprint turns an intent-first .bp file into a typed, runnable Hono or FastAPI project you can inspect, extend, and own.

Install with Homebrew
brew install abdul-hamid-achik/tap/bp
  • MIT licensed
  • Inspectable output
  • No proprietary runtime
todo-api.bpchecked
@ "Create a new todo"
POST /api/todos {
  <- title string required
  |> todo = save todo { title: title }
  -> 201 { id: todo.id, title: todo.title }
}
generated/ready to run
  • routes/Hono handlers
  • models/Drizzle schema
  • validation/Zod contracts
  • frontend/Typed SDK

Choose the right output

One language, honest target status.

  • Node / HonoMature reference
  • Python / FastAPIAdvanced beta
  • Effect / TypeScriptExperimental scaffold
Compare codegen targets

A compiler, not a black box

Every step has a clear job.

Your source is validated before generation, and the output is a standard project—not a proprietary runtime.

  1. 01Source.bp
  2. 02ParseAST
  3. 03Checkstructure + names
  4. 04Resolvesemantic facts
  5. 05Generateproject files

Flow you can scan

Read the left margin. Understand the endpoint.

Inputs arrive, steps transform, outputs return. Intent is syntax—not a comment that drifts away from the code.

Learn the arrow system
<-Input
<- email string required format(email)
|>Step
|> user = fetch user(id)
->Output
-> 200 { id: user.id }
@Intent
@ "Return the current user"
@>Generation slot
@> "implement the scoring logic"

Useful from the first file

The service work is part of the language.

Model the contract once, then carry the same intent into validation, tests, documentation, and deployment.

01 / HTTP + DATA

Typed endpoints and models

Declare request inputs, database models, validation, and response shapes in one readable flow.

02 / BOUNDARIES

Middleware, injected context, and secrets

Keep explicit security and cross-cutting behavior visible without burying the endpoint in framework plumbing.

03 / ASYNC

Workers, schedules, streams

Describe background and realtime work with the same directional syntax.

04 / TOOLCHAIN

Check, test, document, migrate, deploy

A single CLI carries the contract through the rest of the delivery loop.

  • bp check
  • bp test
  • bp docs
  • bp deploy

A short path to running code

Author. Check. Build. Own.

  1. 01

    Author the contract

    Write models, endpoints, and intent in a compact .bp file.

  2. 02

    Check before generating

    Catch syntax, naming, structural, and top-level reference problems with source-level diagnostics.

  3. 03

    Build a familiar project

    Generate routes, schemas, tests, migrations, and project configuration.

  4. 04

    Run it—or eject

    Keep compiling from Blueprint, or remove the markers and take full ownership.

Your service can start as a readable contract

Build the first endpoint in minutes.

Released under the MIT License.