sort-wrangler-json

A CLI tool to sort Wrangler configuration files written in JSON format (wrangler.json or wrangler.jsonc) based on their schema definition while preserving all original comments.

Important

This package is not yet published to any registry. You can use it by cloning the repository and installing it by running pnpm link in the project root.

Features

• Sorts keys within the configuration based on the schema
• Sorts keys within the environment-specific configurations as well as the top-level one
• Places the env key at the end of the configuration for a clear inheritance hierarchy
• Preserves all comments
• Supports both dry-run (write to stdout) and in-place editing modes

Usage

Print the output of the sorting result to stdout:

npx sort-wrangler-json

Options

Option	Short	Type	Description	Default
--config <path>	-c	string	Path to the configuration file	./wrangler.jsonc
--schema <path>	-s	string	Override the schema file path	undefined
--write	-w	boolean	Write the output to the original file	false
--help	-h	boolean	Print help message	false

How It Works

1. Reads the Wrangler configuration file from the current directory (or specified path)
2. Extracts the $schema key to locate the schema file
3. Dynamically builds an ESLint configuration with the jsonc/sort-keys rule based on the schema
4. Applies ESLint's autofixes
5. Writes the output to stdout or the original file