Zum Hauptinhalt springen

Build Fix Guide

Status: Superseded. This page exists as a stable redirect for historical links. Do not update it.

This page has been consolidated into Build Troubleshooting.

Use Build Troubleshooting as the canonical build reference. It covers:

  • Current toolchain baseline (Node, npm, workspaces, tsup, vite).
  • Common build commands per surface (root, docs, demos, playground, test-app).
  • Common failures and fixes (TypeScript config, duplicate exports, forwardRef typing, package resolution, vite/rollup entry, Docusaurus sidebar / locale warnings).
  • General recovery procedures (stepwise build, clean reinstall, type-only check, workspace graph verification).
  • Security and audit checks.
  • When not to fix in-place.

Why this page is a redirect, not a delete​

build-fix-guide.md was previously a step-by-step recovery runbook for a specific historical broken state of the repository (early-2025 lerna setup, missing @smolitux/utils types, npmlog dependency, etc.). The repository has since moved to npm workspaces with shipped types, so most of that runbook no longer applies. The reusable parts have been folded into Build Troubleshooting.

The file is preserved here as a redirect rather than deleted to keep external links and Docusaurus routes stable. The original content remains in git history.

  • Build Troubleshooting — canonical.
  • docs/maintenance/DOCUMENTATION_CONSOLIDATION_PLAN.md — consolidation status (repo path; not published on the docs site).