Files
stack/packages/mosaic/framework/skills/tsdown/references/option-log-level.md
T
fargo 1a822493ba format: apply repo prettier (3.8.1) to the folded skills tree
963 markdown files reformatted with the repository's pinned prettier so
pnpm format:check covers the folded tree like every other repo file.

The formatter's embedded-language pass also normalized code fences
(TS semicolons, closed HTML tags in examples, lowercased CSS hex colors,
one renumbered list that skipped an index). Alphanumeric token deltas vs
the fold commit were audited file-by-file; all are formatter-equivalent
markup normalizations plus the four sanitized skills.
2026-08-19 14:37:17 -05:00

1.9 KiB

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.