Log Level

Control the verbosity of build output.

Overview

The logLevel option controls how much information tsdown displays during the build process.

Type

logLevel?: 'silent' | 'error' | 'warn' | 'info'

Default: 'info'

Basic Usage

CLI

# Suppress all output
tsdown --log-level silent

# Only show errors
tsdown --log-level error

# Show warnings and errors
tsdown --log-level warn

# Show all info (default)
tsdown --log-level info

Config File

export default defineConfig({
  entry: ['src/index.ts'],
  logLevel: 'error',
});

Available Levels

Level	Shows	Use Case
`silent`	Nothing	CI/CD pipelines, scripting
`error`	Errors only	Minimal output
`warn`	Warnings + errors	Standard CI/CD
`info`	All messages	Development (default)

Common Patterns

CI/CD Pipeline

export default defineConfig({
  entry: ['src/index.ts'],
  logLevel: 'error', // Only show errors in CI
});

Scripting

export default defineConfig({
  entry: ['src/index.ts'],
  logLevel: 'silent', // No output for automation
});

Fail on Warnings

The failOnWarn option controls whether warnings cause the build to exit with a non-zero code. Defaults to 'ci-only' — warnings fail the build in CI but not locally.

export default defineConfig({
  failOnWarn: 'ci-only', // Default: fail on warnings only in CI
  // failOnWarn: true,   // Always fail on warnings
  // failOnWarn: false,  // Never fail on warnings
});

See CI Environment for more about CI-aware options.

CI Environment - CI-aware option details
CLI Reference - All CLI options
Config File - Configuration setup

1.9 KiB Raw Blame History