goflare

GoFlare

GoFlare is a self-contained Go tool (library + CLI) for deploying Go WASM projects to Cloudflare Workers and Pages. No Node.js, no Wrangler, no GitHub Actions. Pure Go, direct Cloudflare API.

🚀 Features

• Zero Dependencies: No Node.js or Wrangler required.
• Go → WASM/JS: Seamlessly compiles Go to WASM for the edge.
• Dual Target: Supports both Cloudflare Workers and Cloudflare Pages.
• Direct Upload: Uses Cloudflare's Direct Upload v2 API for Pages.
• Secure Auth: Uses the system keyring to store your Cloudflare API token.
• Pure Go: Entirely written in Go.

💻 CLI Usage

Install the CLI:

go install github.com/tinywasm/goflare/cmd/goflare@latest

1. Initialize

Set up your project and create a .env file with necessary configurations.

goflare init

2. Build

Compile your Go code to WASM and prepare assets.

goflare build

3. Deploy

Push your project to Cloudflare.

goflare deploy

📚 Library Usage

GoFlare can also be used as a library in your own Go tools.

import (
    "os"
    "github.com/tinywasm/goflare"
)

func main() {
    cfg := &goflare.Config{
        ProjectName: "myapp",
        AccountID:   "abc1234567890",
        Entry:       "edge/main.go",
        PublicDir:   "public",
    }

    g := goflare.New(cfg)

    // Build
    if err := g.Build(); err != nil {
        panic(err)
    }

    // Deploy
    store := goflare.NewKeyringStore()
    if err := g.Auth(store, os.Stdin); err != nil {
        panic(err)
    }

    if err := g.DeployWorker(store); err != nil {
        panic(err)
    }

    if err := g.DeployPages(store); err != nil {
        panic(err)
    }
}

📁 Project Structure

A GoFlare project follows this fixed convention (not configurable):

my-project/
├── .env                 # credentials — gitignored
├── .env.example         # public template
├── .build/              # build output — gitignored
│   ├── edge.js          # bundled + minified JS (wasm_exec + runtime + entry)
│   ├── edge.wasm        # compiled edge function binary
│   └── dist/            # Pages upload staging (copy of web/public/)
├── web/
│   ├── client.go        # //go:build wasm  — frontend WASM (browser)
│   ├── server.go        # //go:build !wasm — backend for local dev (tinywasm)
│   └── public/          # PUBLIC_DIR in .env
│       ├── index.html
│       └── client.wasm  # generated by goflare build
└── edge/
    └── main.go          # //go:build wasm  — edge function backend (Cloudflare)

Fixed rules:

• Frontend WASM source: always web/client.go
• Static assets: always web/public/ (PUBLIC_DIR)
• Edge function: always edge/main.go (auto-detected — no ENTRY needed)
• Build output: always .build/

⚙️ Configuration

Configuration is primarily loaded from a .env file or environment variables.

*At least one of ENTRY or PUBLIC_DIR must be provided.

🛠️ Requirements

• Go 1.25.2+
• TinyGo in your PATH (for Worker builds)

📝 License

Distributed under the MIT License. See LICENSE for more information.