Make Prettier formatting automatic - #1060
Merged
Merged
Conversation
Contributor
|
🔍 Mintlify preview for this branch: https://daily-pk-prettier-tooling.mintlify.site |
kompfner
requested review from
aconchillo,
filipi87,
markbackman and
mattieruth
August 5, 2026 16:48
Prettier ships as a dev dependency pinned in package-lock.json, so contributors, the pre-commit hook, and the docs bot all format identically. lint-staged runs it over staged files only, which keeps the hook fast and leaves unstaged work untouched. .nvmrc pins the Node version, and CI reads it rather than hardcoding one. The setup instructions install Node from .nvmrc, pull the Mintlify CLI in with the rest of the dependencies, and invoke it through npx. The project structure listing and navigation example name directories and pages that exist.
Brings every page to the .prettierrc style so formatting no longer surfaces as noise in content PRs. The changes are presentation only: prose reflow, table padding, JSX spacing, and emphasis-marker normalization. The XTTS deprecation warning gains a blank line before its closing tag. A markdown list flush against a closing JSX tag makes that tag parse as part of the final list item, which MDX rejects.
kompfner
force-pushed
the
pk/prettier-tooling
branch
from
August 5, 2026 16:51
336e99e to
b3f15e8
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This repo has intended to use Prettier for a long time —
.prettierrclanded 20 months ago, and bothCONTRIBUTING.mdandCLAUDE.mdtell you to run it. Nothing enforced it, so 112 files had drifted out of style.Commit 1 adds
prettier,husky, andlint-stagedas pinned dev dependencies, with a pre-commit hook that formats staged files..nvmrcpins Node 24 and CI reads it.Commit 2 formats the whole site — presentation only, except
xtts.mdx, where Prettier's output needed a blank line before a closing<Warning>tag to stay valid MDX.prettier --checkis clean, every page compiles as MDX,mint broken-linkspasses, and all 911 link targets are unchanged. Test-merged against all 12 open PRs: #1054 overlaps 89 reformatted files and merges cleanly, and nothing else is newly affected.Companion: pipecat-ai/pipecat#5226 makes the docs bot format the PRs it generates. Merge this one first.