add prettier tooling

Author: andrewkmin

.prettierignore

@@ -132,3 +132,12 @@ test-results/
 playwright-report/
 playwright/.cache/
 
+# Generated API artifacts (regenerated via `make gen`)
+public_api.swagger.json
+proxy_api.swagger.json
+scripts/openapi-gen/openapi.json
+scripts/openapi-gen/proxy_api_openapi.json
+
+# Synced from the SDK repo via `make sync-sdk-gen-docs` (don't reformat in place)
+generated-docs/
+

Makefile

@@ -1,12 +1,20 @@
 ROOT := $(shell git rev-parse --show-toplevel)
 JS_SDK_ROOT := $(ROOT)/../sdk
 
-.PHONY: openapi-gen gen tags mintlify-check
+.PHONY: openapi-gen gen tags mintlify-check format format-check
 
 # Convenience method to start dev server
 dev:
 	mintlify dev
 
+# Format all hand-written content with Prettier (mdx, md, css, json, ts, js, ...)
+format:
+	npm run format
+
+# Check formatting without writing changes (use in CI)
+format-check:
+	npm run format:check
+
 # Install deps for OpenAPI
 install:
 	cd scripts/openapi-gen && npm install

README.md

@@ -25,6 +25,21 @@ mintlify dev
 
 This will start a local development server where you can preview your changes in real-time.
 
+### Formatting
+
+This repo uses [Prettier](https://prettier.io) to format all hand-written content (`.mdx`, `.md`, `.css`, `.json`, `.ts`, `.js`, ...). Generated artifacts (swagger files, `generated-docs/`) are excluded via `.prettierignore`.
+
+```sh
+# Install dev dependencies (one time)
+npm install
+
+# Format everything in place
+npm run format   # or: make format
+
+# Check formatting without writing (useful in CI)
+npm run format:check   # or: make format-check
+```
+
 If you encounter any issues with the development server:
 
 - Run `mintlify install` to reinstall dependencies