golang-boost

Boost

Overview

Boost is a modular and extensible framework for Go application development, designed to simplify the creation of robust, scalable, and observable services. The framework provides a comprehensive set of components that can be used independently or combined to build complete applications.

Key Features

• Modular Architecture: Independent components that can be used as needed
• Dependency Injection: Flexible system for managing dependencies between components
• Integrated Observability: Native support for metrics, logging, and tracing
• Adapters for Popular Libraries: Consistent wrappers for various libraries in the Go ecosystem
• Design Patterns: Implementations of patterns such as Factory, Middleware, and Wrapper
• CloudEvents Support: Native integration with the CloudEvents standard
• Extensibility: Easy to add support for new libraries and frameworks

Project Structure

The project is organized into modular packages, each with specific responsibilities:

• bootstrap: Components for application initialization
• examples: Framework usage examples
• extra: Additional functionalities (health checks, middleware, multiserver)
• factory: Factory pattern implementations for various components
• fx: Dependency injection and lifecycle management
• model: Data structures and interfaces definitions
• utils: Various utilities
• wrapper: Adapters for external libraries (cache, config, log, publisher)

Getting Started

Prerequisites

• Go 1.18 or higher
• Specific dependencies vary according to the components used

Installation

go get github.com/xgodev/boost

Basic Example

package main

import (
	"github.com/xgodev/boost"
	"github.com/xgodev/boost/factory/contrib/go.uber.org/zap/v1"
	"github.com/xgodev/boost/wrapper/log"
	"os"
)

func init() {
	os.Setenv("BOOST_FACTORY_ZAP_CONSOLE_FORMATTER", "JSON")
	os.Setenv("BOOST_FACTORY_ZAP_CONSOLE_LEVEL", "DEBUG")
}

func main() {
	boost.Start()
	log.Set(zap.NewLogger())
	log.Infof("hello world!!")
}

Claude Code plugin

This repo ships a Claude Code plugin (golang-boost) that teaches AI agents how to write boost-shaped Go code — Iron Laws (boost.Start, handler typing, config layer), HTTP APIs with Echo, event-driven functions, and the maintainer-side layout for new contribs. Install once in your Claude Code session:

/plugin marketplace add xgodev/boost
/plugin install golang-boost@xgodev

Update

Inside Claude Code:

/plugin update golang-boost

From the CLI:

claude plugin update golang-boost@xgodev

If it reports Plugin "..." not found, pass the scope explicitly:

claude plugin update golang-boost@xgodev --scope user   # or: project | local | managed

Use claude plugin list to find the scope where the plugin is installed.

Auto-update

Claude Code checks for plugin updates at startup, but third-party marketplaces have auto-update disabled by default — only Anthropic's official marketplaces update on their own. To enable it:

Interactive: run /plugin → Marketplaces → select xgodev → Enable auto-update.

Or declaratively, in ~/.claude/settings.json (global) — add "autoUpdate": true to the marketplace entry under extraKnownMarketplaces:

{
  "extraKnownMarketplaces": {
    "xgodev": {
      "source": {
        "source": "git",
        "url": "git@github.com:xgodev/boost.git"
      },
      "autoUpdate": true
    }
  }
}

The same works in a project's .claude/settings.json to pin auto-update for the team via the repo. Restart Claude Code for the change to take effect.

An update is only recognized when the version in .claude-plugin/plugin.json is incremented. Commits without a version bump do not trigger an update — even with auto-update on, Claude Code reports "already at latest".

Main Components

Bootstrap

The Bootstrap package provides components for application initialization, including support for serverless functions and event processing.

Bootstrap Documentation

Factory

The Factory package implements the Factory design pattern for various components, facilitating the creation and configuration of complex objects.

Factory Documentation

Wrapper

The Wrapper package provides adapters for external libraries, including cache, configuration, logging, and message publishing.

Wrapper Documentation

FX

The FX package provides dependency injection and component lifecycle management functionalities.

FX Documentation

Extra

The Extra package includes additional functionalities such as health checks, middleware, and support for multiple servers.