rose-pine · mvllow · Nov 16, 2025 · Nov 16, 2025
diff --git a/Makefile b/Makefile
@@ -1,23 +1,27 @@
 .PHONY: all
-all: docs build
+all: format build test
+
+.PHONY: docs
+docs:
+	go generate
 
 .PHONY: build
 build:
 	go build -o bloom .
 
-.PHONY: docs
-docs:
-	go run . doc --format md bloom_doc/
-
 .PHONY: test
 test:
 	go test ./...
 
-.PHONY: fmt
-fmt:
+.PHONY: format
+format:
 	go fmt ./...
 
 .PHONY: check
 check:
 	golangci-lint run ./...
 
+.PHONY: clean
+clean:
+	rm -f bloom
+	rm -rf docs/*.md
diff --git a/README.md b/README.md
@@ -41,14 +41,21 @@ go build -o $(go env GOPATH)/bin/bloom github.com/rose-pine/rose-pine-bloom
 
 ## Usage
 
-Start by creating a template file. This will look similar to your desired theme file, replacing colour values with Rosé Pine variables. For example, `#ebbcba` would now be `$rose`. Already have a theme? You can [create a template](#create-a-template) from an existing theme.
+> See our [full documentation](./docs/bloom.md) for more information.
 
-See
-- [cli documentation](./bloom_doc/bloom.md)
-- [process a template](./bloom_doc/bloom_build.md)
-- [create a template from a theme](./bloom_doc/bloom_build-template.md)
+For existing themes, use `bloom init` ([docs](./docs/bloom_init.md)) to create a template, for example:
 
+```sh
+bloom init theme.json
+# This will create a template.json file in the same directory
+```
+
+To build your themes, use `bloom build` ([docs](./docs/bloom_build.md)):
 
+```sh
+bloom build template.json
+```
+
 ### Variables
 
 > By default, variables are prefixed with `$`
@@ -121,12 +128,6 @@ It is possible to use variables inside of this syntax as well:
 
 We welcome and appreciate contributions of any kind. Please create an issue for any proposed changes.
 
-### Build documentation
-
-```sh
-make docs
-```
-
 ## Related
 
 - [rose-pine/build](https://github.com/rose-pine/build) - Node.js-based theme generator for Rosé Pine
diff --git a/bloom_doc/bloom.md b/bloom_doc/bloom.md
diff --git a/bloom_doc/bloom_build.md b/bloom_doc/bloom_build.md
diff --git a/bloom_doc/bloom_completion.md b/bloom_doc/bloom_completion.md
diff --git a/bloom_doc/bloom_completion_bash.md b/bloom_doc/bloom_completion_bash.md
diff --git a/bloom_doc/bloom_completion_fish.md b/bloom_doc/bloom_completion_fish.md
diff --git a/bloom_doc/bloom_completion_powershell.md b/bloom_doc/bloom_completion_powershell.md
diff --git a/bloom_doc/bloom_completion_zsh.md b/bloom_doc/bloom_completion_zsh.md
diff --git a/bloom_doc/bloom_doc.md b/bloom_doc/bloom_doc.md
diff --git a/bloom_doc/bloom_init.md b/bloom_doc/bloom_init.md