Getting Started

Install fuku and get your services running in minutes.

Installation

Homebrew

brew install tab/apps/fuku

Build from Source

git clone https://github.com/tab/fuku.git
cd fuku
go build -o cmd/fuku cmd/main.go
sudo ln -sf $(pwd)/cmd/fuku /usr/local/bin/fuku

Quick Start

1. Generate a config file in your project root:

fuku init

2. Edit fuku.yaml to define your services, tiers, and profiles. See the Configuration page for the full reference.

3. Run your services:

# Run with the default profile (interactive TUI)
fuku

# Run a specific profile
fuku run core

# Run without TUI
fuku run core --no-ui

Service Requirements

Each service directory must contain a Makefile with a run target. Fuku executes make run inside each service's directory.

# Makefile
run:
	npm start

If a .env.development file exists in the service directory, fuku automatically detects it and passes it via the ENV_FILE variable.

Check the examples directory for reference configurations.