Skip to content

Tailwind CSS External Build Artifact

Protocol

zenzic-tailwind.min.css is an external build artifact produced by a human-run Tailwind CLI v4 process. It is not generated by CI (Pillar 3: Zero Subprocess).

Build Instructions (Human Operator Only)

# Prerequisites: Node.js + Tailwind CLI installed locally (NOT in CI)
npx @tailwindcss/cli -i ./tailwind-input.css -o ./docs/assets/css/zenzic-tailwind.min.css --minify

Critical Constraints

  • Preflight DISABLED: The CSS Reset (Preflight) must be disabled in tailwind-input.css via @layer base {} override or preflight: false in Tailwind config, to prevent interference with Zensical/MkDocs Material base typography.
  • Commit the output: After building locally, commit zenzic-tailwind.min.css to the repository. CI will serve it as a static file.
  • just build-docs enforces presence: The build target fails with exit 1 if this file does not exist before invoking uvx uv run mkdocs build.