TypeScript-First: Full type safety with IntelliSense support for all configurations
Runtime Validation: Catch configuration errors early with Zod-based validation
Preset System: Pre-configured workflows for npm packages, GitHub releases, and monorepos
Plugin Development: Complete toolkit for creating custom semantic-release plugins
Configuration Composition: Fluent API and composition utilities for complex setups
Environment Awareness: Automatic environment detection and configuration optimization

Quick Start

Installation

# npm
npm install --save-dev @bfra.me/semantic-release semantic-release

# pnpm
pnpm add --save-dev @bfra.me/semantic-release semantic-release

# yarn
yarn add --dev @bfra.me/semantic-release semantic-release

Basic Usage

// release.config.ts
import { defineConfig } from '@bfra.me/semantic-release'

export default defineConfig({
  branches: ['main'],
  plugins: [
    '@semantic-release/commit-analyzer',
    '@semantic-release/release-notes-generator',
    '@semantic-release/changelog',
    '@semantic-release/npm',
    '@semantic-release/github',
    '@semantic-release/git',
  ],
})

Using Presets

// NPM package preset
import { npmPreset } from '@bfra.me/semantic-release'

export default npmPreset({
  branches: ['main', { name: 'beta', prerelease: true }],
  repositoryUrl: 'https://github.com/user/package'
})

Builder Pattern

// Fluent API for complex configurations
import { createConfigBuilder } from '@bfra.me/semantic-release/builder'

export default createConfigBuilder()
  .branches(['main', 'beta'])
  .plugins()
    .commitAnalyzer()
    .releaseNotesGenerator()
    .changelog()
    .npm()
    .github()
    .git()
  .build()

Documentation

Getting Started Guide - Comprehensive guide to TypeScript semantic-release configuration
API Reference - Complete TypeScript API documentation
Migration Guide - Coming in TASK-046
Plugin Development Tutorial - Coming in TASK-043