nix-builder-image/CLAUDE.md

Nix Image Builder Project Guide

Project Information

• Description: Docker image builder for Gitea Actions runner with Nix support
• Primary use case: Running Gitea Actions in a Kubernetes cluster

Common Commands

Building

# Build the Docker image
just build

# Load the image into Docker
just load

# Build and load in one step
just build-load

Testing

# Run tests
just test

Code Formatting

# Format code
just fmt

Development

# Start a development shell
nix develop

Project Structure

• flake.nix - Main Nix configuration file for the project
• justfile - Task runner configuration
• treefmt.nix - Code formatting configuration

Key Dependencies

• Nix package manager
• Docker
• Just command runner