goflare

README

GoFlare

GoFlare is a lightweight and flexible handler designed to help you build and deploy Go-based WebAssembly (WASM) and JavaScript bundles for Cloudflare Workers, Pages, or Functions.

It’s not a full framework — GoFlare is meant to fit into your existing toolchain. You can use it as a standalone build step or attach it to any build or deploy workflow you already have.

---

🚀 Features

• Go → WASM/JS conversion made simple
• Compatible with Cloudflare’s edge platforms (Workers, Pages, and Functions)
• Integrates easily with CI/CD pipelines or other Go tools
• Minimal dependencies and lightweight footprint
• Provides a unified handler interface to hook into other builders or deployment systems

---

🧩 Example Usage

import "github.com/cdvelop/goflare"

---

Contributing

Documentation

Index

• type Config
• type Goflare
  • func New(c *Config) *Goflare
  • func (g *Goflare) GeneratePagesFiles() error
  • func (g *Goflare) GenerateWorkerFiles() error

Types

type Config

type Config struct {
	AppRootDir                 string // default: "."
	WorkerDirSubRelativeOutput string // output path for worker.js and app.wasm file (relative) eg: "deploy"
	MainInputFile              string // eg: "main.worker.go"
	Logger                     func(message ...any)
	CompilingArguments         func() []string
	// Pages-specific configuration
	PagesApiRoutePrefix string // API route prefix for Pages Functions (default: "/api/")
	PagesWasmFileName   string // WASM file name for Pages Functions (default: "app.wasm")
}

type Goflare

type Goflare struct {
	// contains filtered or unexported fields
}

func New

func New(c *Config) *Goflare

func (*Goflare) GeneratePagesFiles

func (g *Goflare) GeneratePagesFiles() error

GeneratePagesFiles generates all necessary files for Cloudflare Pages Functions using Advanced Mode

func (*Goflare) GenerateWorkerFiles

func (g *Goflare) GenerateWorkerFiles() error