Laner

0.1.0

Star
Swift-native CI/CD automation tool for iOS and macOS projects
automation ci-cd cli code-signing ios macos swift testflight xcode fastlane-alternative
alexey1312/Laner

What's New

v0.1.0

2025-11-27T18:32:47Z

Full Changelog: https://github.com/alexey1312/Laner/commits/v0.1.0

Laner

CI Latest Release License

A Swift-native CI/CD automation tool for iOS and macOS projects.

Features

  • Build & Test: Build and test iOS/macOS projects with xcodebuild
  • Code Signing (Match): Git-based certificate and profile management, Fastlane Match compatible
  • TestFlight Upload: Upload builds to TestFlight with chunked uploads and beta distribution
  • Environment Detection: Automatic CI detection (GitHub Actions, GitLab CI, Jenkins, etc.)
  • Lane DSL: Define CI/CD workflows using Swift
  • Type-Safe Actions: Build custom actions with full Swift type safety
  • Structured Logging: Configurable logging with color support
  • Async/Await: Modern Swift 6 concurrency throughout

Requirements

  • macOS 13.0+
  • Swift 6.0+
  • Xcode 16.0+ (for iOS/macOS build operations)

Installation

Using mise (recommended)

mise use -g ubi:alexey1312/Laner

Or add to .mise.toml:

[tools]
"ubi:alexey1312/Laner" = "latest"

From Source

git clone https://github.com/alexey1312/Laner.git
cd Laner
swift build -c release

The executable will be available at .build/release/laner.

Manual Download

Download from GitHub Releases.

Quick Start

# Check environment
laner doctor

# Initialize Laner in your project
laner init

# List available lanes
laner lanes

# Execute a lane
laner lane build

Commands

Command Description
version Show Laner version and environment
doctor Check environment for required tools
init Initialize a new Laner project
lanes List available lanes from manifest
lane <name> Execute a lane by name
build Build an iOS or macOS project
test Run tests for an iOS or macOS project
match Code signing management (sync, nuke, register)
upload testflight Upload IPA to TestFlight

DSL Example

// Laner/Lanerfile.swift
import LanerDSL

let laner = Lanerfile(
    lanes: [
        Lane("build") {
            gym(scheme: "App", configuration: .debug)
        },
        Lane("test") {
            scan(scheme: "AppTests", codeCoverage: true)
        },
        Lane("release") {
            match(type: .appstore)
            gym(scheme: "App", configuration: .release)
            archive(scheme: "App", exportMethod: .appStore)
        },
        Lane("testflight") {
            match(type: .appstore, readonly: true)
            gym(scheme: "App", exportMethod: .appStore)
            pilot(
                appId: "123456789",
                changelog: "Bug fixes and improvements",
                groups: ["Internal Testers"]
            )
        }
    ]
)

Module Structure

  • laner - CLI executable
  • LanerCore - Internal implementation (commands, orchestration)
  • LanerDSL - Public DSL API for defining lanes and actions
  • LanerKit - Shared utilities (shell execution, logging, xcodebuild)
  • LanerPluginKit - Plugin development kit
  • LanerMatch - Code signing management (Match-compatible)

Environment Variables

Variable Description
MATCH_PASSWORD Encryption password for certificates
MATCH_GIT_URL Git repository URL for certificate storage
MATCH_TEAM_ID Apple Developer Team ID
APP_STORE_APP_ID App Store Connect App ID (for pilot action)
APP_STORE_CONNECT_API_KEY_ID App Store Connect API Key ID
APP_STORE_CONNECT_API_ISSUER_ID App Store Connect Issuer ID
APP_STORE_CONNECT_API_KEY_PATH Path to .p8 private key file

Documentation

Document Description
Usage Guide Step-by-step usage instructions
Инструкция (RU) Пошаговая инструкция на русском
Actions Reference Available DSL actions and custom action development
Environment Variables Complete environment variable reference
Implementation Plan Architecture and development roadmap
Fastlane Analysis Comparison with Fastlane

Development

# Build
swift build

# Run tests
swift test

# Run the CLI
swift run laner --help

# Build for release
swift build -c release

Roadmap

Implemented

  • CLI with ArgumentParser (build, test, doctor, version, init, lanes, lane, match, upload)
  • ShellExecutor — async process runner
  • XcodebuildExecutor — build/test/archive wrapper
  • Structured logging with color support
  • CI environment detection
  • Lane and Action protocols
  • Lane execution from Swift manifests — laner lane <name>
  • LaneBuilder result builder for declarative DSL
  • Built-in actions: gym(), scan(), archive(), match(), registerDevices(), pilot()
  • Manifest compilation and caching
  • Code Signing (Match) — git-based certificate management, Fastlane Match compatible
  • TestFlight Upload — chunked IPA upload via Build Upload API v4.1+, beta group distribution

Planned

  • App Store Connect (Full) — App Store submission (deliver()), metadata, screenshots, phased release
  • Firebase App Distribution — upload and tester management
  • Notifications — Slack, Jira integrations
  • Metrics — build time tracking, IPA size monitoring
  • Plugin system — extensible architecture

License

MIT License - see LICENSE file for details.

Description

  • Swift Tools 6.0.0
View More Packages from this Author

Dependencies

Last updated: Mon Jan 19 2026 16:29:20 GMT-1000 (Hawaii-Aleutian Standard Time)