An attempt at a complete Go port of Less.js - the popular CSS preprocessor. This implementation aims to maintain 100% feature parity with Less.js v4.4.2 while providing the performance benefits of a native Go binary.

Current Release - Fully compatible with Less.js v4.4.2

• 195/195 integration tests passing (100%)
• 100 perfect CSS matches with Less.js output
• 91 error handling tests correctly failing as expected
• All unit tests passing

Install the pre-built binary for your platform:

npm install lessgo

This automatically installs the correct binary for your operating system and architecture.

go install github.com/toakleaf/less.go/cmd/lessc-go@latest

Or add the library to your Go project:

go get github.com/toakleaf/less.go/less

# Basic compilation
npx lessc-go input.less output.css

# With compression
npx lessc-go --compress input.less output.css

# Read from stdin, write to stdout
cat input.less | npx lessc-go -

# With source map
npx lessc-go --source-map input.less output.css

# Include paths for @import resolution
npx lessc-go --include-path=./mixins:./node_modules input.less output.css

package main

import (
    "fmt"
    "log"

    less "github.com/toakleaf/less.go/less"
)

func main() {
    source := `
        @primary: #4a90d9;

        .button {
            background: @primary;
            color: white;
            &:hover {
                background: darken(@primary, 10%);
            }
        }
    `

    result, err := less.Compile(source, nil)
    if err != nil {
        log.Fatal(err)
    }

    fmt.Println(result.CSS)
}

result, err := less.Compile(source, &less.CompileOptions{
    Filename:    "styles.less",
    Compress:    true,
    StrictUnits: true,
    Math:        less.Math.ParensDivision,
    Paths:       []string{"./imports", "./node_modules"},
    GlobalVars: map[string]any{
        "theme-color": "#ff6600",
    },
})

less.go provides native binary performance without requiring a JavaScript runtime:

• No JIT warmup required - Consistent performance from first run
• Native binary - No JavaScript runtime needed for core functionality

Run benchmarks yourself:

pnpm bench:compare:suite  # Recommended: realistic full-suite comparison
pnpm bench:compare        # Per-file comparison (for debugging)

less.go implements 100% feature parity with Less.js v4.4.2:

• Variables - @primary: #333;
• Nesting - Nested rules and selectors
• Mixins - Parametric, guards, closures, recursion
• Extend - &:extend(.class)
• Import - Including npm module resolution
• Functions - All 60+ built-in functions
• Detached Rulesets - Reusable rule blocks
• CSS Guards - Conditional CSS
• Media Query Bubbling - Automatic media query handling
• Container Queries - @container with size and style queries
• CSS Layers - @layer at-rule and import with layer()
• Property Merge - + and +_ operators
• Compression - CSS minification
• Source Maps - Full source map support
• JavaScript Plugins - Custom functions via Node.js bridge

less.go/
├── less/              # Go implementation (core library)
├── cmd/lessc-go/      # CLI tool
├── testdata/          # Test fixtures
├── test/js/           # JavaScript unit tests
├── npm/               # NPM package templates
├── reference/less.js/ # Original Less.js (git submodule, reference only)
├── examples/          # Usage examples
└── scripts/           # Build and test scripts

• Go 1.21+
• Node.js 18+ (for JavaScript plugin support and tests)
• pnpm

# Clone with submodules
git clone --recurse-submodules https://github.com/toakleaf/less.go.git
cd less.go

# Or if already cloned, initialize submodules
git submodule update --init --recursive

# Install dependencies
pnpm install

# Run all integration tests
pnpm test:go

# Run Go unit tests
pnpm test:go:unit

# Run JavaScript unit tests
pnpm test:js-unit

# Quick summary (recommended)
LESS_GO_QUIET=1 pnpm test:go 2>&1 | tail -100

# Compare Go vs JavaScript performance
pnpm bench:compare

# Go benchmarks
pnpm bench:go:suite

See CONTRIBUTING.md for guidelines on:

• Setting up the development environment
• Running tests
• Submitting pull requests

• Less.js - Original JavaScript implementation
• lesscss.org - LESS language documentation

Apache License 2.0 - See LICENSE

less.go is a complete Go port, not a fork. It shares no code with Less.js but maintains 100% compatibility through comprehensive testing against the original implementation.