lazy

Name

lazy - create, run, inspect, and upgrade GoLazy applications.

Install

curl -fsSL https://golazy.dev/install.sh | sh
go install golazy.dev/lazy@latest

The import path golazy.dev/lazy resolves to the github.com/golazy/lazy repository through this page's Go vanity metadata.

Synopsis

lazy [--cmdpath <path>] [--viewpath <path>] [--publicpath <path>]
lazy new [--version <version>] [--skip-update-check] <module>
lazy routes [--cmdpath <path>] [--viewpath <path>] [--publicpath <path>]
lazy dump <dataset>
lazy load <dataset>
lazy upgrade [--target <version>] [--dry-run] [--skip-commands]
lazy native [--cmdpath <path>] [--viewpath <path>] [--publicpath <path>] [--title <title>] [--width <px>] [--height <px>]
lazy native build [--target <current>] [--cmdpath <path>] [--out <dir>]
lazy docs [--dir <path>] [--json] [query]
lazy add [--dry-run] [--manifest <path>] <addon>[@version]
lazy remove [--dry-run] [--manifest <path>] <addon>
lazy update [--dry-run] [--manifest <path>] [addon ...]
lazy addons
lazy js
lazy tailwind [--input <path>] [--output <path>] [--watch]
lazy --version

Description

lazy runs the development loop for a GoLazy application, creates new applications from the version-matched sample template, prepares local services, manages local datasets, regenerates browser assets, installs exact add-ons, prints routes and package docs, runs the native helper, and applies supported application upgrades.

Commands

lazy: Builds a temporary lazydev binary, starts the app behind a local proxy, serves the development panel, watches files, and reloads or restarts as needed.
lazy new: Creates a generated app, installs its mise tools, validates it, initializes Git, and commits the initial checkout.
lazy routes: Prints the route table without starting the HTTP server.
lazy dump: Runs service dump tasks into datasets/<dataset>/<service>.dump.
lazy load: Runs service load tasks from matching dataset dump files.
lazy upgrade: Applies supported versioned migrations and follow-up checks for an existing app.
lazy native: Runs the current app through the native desktop helper.
lazy native build: Builds a current-platform native package through the helper.
lazy docs: Searches or exports GoLazy package documentation from a module.
lazy add / remove / update / addons: Plans, installs, maintains, and lists exact manifest-driven application add-ons recorded in addons.toml.
lazy js: Installs browser package dependencies when needed, bundles JavaScript entrypoints, and writes the importmap and generated modules.
lazy tailwind: Compiles Tailwind CSS into the app public stylesheet, with optional watch mode.

Environment

Set LAZY_MULTIVERSION=off to keep app-bound commands on the directly invoked binary during local CLI testing.

Set ADDR or PORT to change the public development address used by lazy.

Development Environment

Generated GoLazy apps use mise as the standard development environment. lazy new trusts the generated mise.toml, runs mise install, and validates the app with the current go on PATH.

Go itself should not be listed in generated app mise.toml files. Go already bundles multi-version support through the go directive and toolchain selection.

Apps can list services in lazy.toml. Otherwise, lazy discovers service names from mise tasks ending in :start.