Prettier⁺ for Nova

The Swiss Army knife for code formatting — seamlessly format JavaScript, TypeScript, JSON, CSS, HTML, Markdown, and more in Nova, with built-in support for Astro, EJS, Java, Laravel Blade, Liquid, PHP, SQL, Tailwind CSS, TOML, Twig, and XML — no extra setup required.

⚠️ Prettier⁺ is a drop-in replacement for the original Prettier Extension. To avoid conflicts, make sure to disable the original before installing or activating Prettier⁺.

Features

• Format on Save: Automatically format your code on save (this setting can be customized per project), or manually format using Editor > Prettier⁺ > Format Document (⌥⇧F).
• Format Document (Forced): Ignores .prettierignore and Ignored Syntaxes, formatting anyway via Editor > Prettier⁺ > Format Document (Forced).
• Format Selection: Precisely formats only the highlighted portion of your code (currently supports JavaScript, TypeScript, GraphQL, and Handlebars).
• Advanced Syntax Detection: Reliably detects the correct syntax based on file extension — even when Nova misidentifies it. Blade, Java, SQL, and more are correctly handled out of the box.

• Language Support: Supports all Prettier-supported languages, including Angular, CSS, Flow, GraphQL, HTML, JavaScript, JSON, JSX, Less, Markdown, SCSS, TypeScript, Vue, and YAML — plus additional ones via bundled plugins, such as Astro, EJS, Java, Laravel Blade, Liquid, PHP, SQL, Tailwind CSS, TOML, Twig, and XML.

• Configuration Support: Compatible with standard Prettier configuration, and .prettierignore files.

• Plugin Usage: Utilizes Prettier and any plugins installed in your project, or defaults to the bundled Prettier and plugins if none are installed.

Bundled Plugins

Plugin	Status	Notes
@prettier/plugin-php	✅ Enabled	–
@prettier/plugin-xml	✅ Enabled	–
prettier-plugin-astro	✅ Enabled	⚠️ Recommended: Astro
prettier-plugin-blade	✅ Enabled	⚠️ Recommended: Laravel Suite
prettier-plugin-ejs	✅ Enabled	–
prettier-plugin-ejs-tailwindcss	✅ Enabled	⚠️ Requires: prettier-plugin-tailwindcss
prettier-plugin-java	✅ Enabled	⚠️ Recommended: Java Language Definition
prettier-plugin-liquid	✅ Enabled	⚠️ Recommended: Liquid
prettier-plugin-nginx	✅ Enabled	⚠️ Recommended: NGINX for Nova
prettier-plugin-properties	✅ Enabled	⚠️ Recommended: Java Language Definition
prettier-plugin-sql	✅ Enabled	⚠️ Recommended: SQL
prettier-plugin-tailwindcss	➕ Optional	⚠️ Recommended: Tailwind CSS
prettier-plugin-toml	✅ Enabled	⚠️ Recommended: TOML
prettier-plugin-twig	✅ Enabled	⚠️ Recommended: Twig

Plugin Legend

• ✅ Enabled by Default — All plugins are active out of the box.

• ➕ Tailwind (Optional) — Tailwind CSS support is included but disabled by default. Enable it via the extension or project settings.

• ⚠️ Extension Recommended — These plugins work best when the corresponding Nova syntax extension is installed.

If you want to see other plugins being integrated, head over to the Discussions.

Versioning

Prettier⁺ for Nova follows Semantic Versioning, aligned with official Prettier releases. Versions are formatted as a.b.c, where:

• a.b corresponds to the bundled Prettier version.
• c is the extension’s specific build number (used for fixes or enhancements unrelated to the Prettier core).

For example, 3.5.4 uses Prettier v3.5.x and is the fourth extension build.

Contributing Translations

Help translate Prettier⁺ for Nova and make it accessible to more developers in your language!

You can contribute translations directly via Weblate.

No coding experience required — just a GitHub or Weblate account and a few minutes of your time.

All contributions are greatly appreciated!

Acknowledgments

This extension builds upon the outstanding work of Alexander Weiss, who created the original Nova Prettier Extension. Without his efforts, this project would not have been possible.

3.5.40 – 2025-05-07

Added

• Centralized Notification Handling
• Introduced notifications.js to encapsulate all Nova NotificationRequest logic.
• Provides showNotification() for posting UI notifications with optional actions and callbacks.
• Provides cancelNotification() to dismiss notifications by ID.

Refactored

• Notification API
• Notification fields like type, placeholder, and inputValue are now only set when explicitly defined.
• Results in cleaner, more predictable UI behavior.
• Simplified notification calls throughout the codebase for improved maintainability and testability.

3.5.39 – 2025-05-06

Development

• Added ESLint as a dev dependency and linted the entire codebase.
• Applied ESLint auto-fixes and suppressed false-positive warnings (e.g., unused variables).
• Added eslint-config-prettier and aligned ESLint rules with Prettier’s formatting.

Refactored

• Consolidated plugin-loading logic into a lookup map for clearer, DRY syntax-to-plugin resolution.

3.5.38 – 2025-05-05

Added

• Stale-response cancellation for Prettier: track in-flight requests per file URI and ignore outdated replies
• JSON-RPC handler unsubscription API and automatic unpipe/destroy on fatal parser errors

Changed

• JSON-RPC parser: revamped to a buffer-of-buffers strategy, dynamic \r?\n\r?\n header detection, stale-byte pruning, proper callback error signaling, optional logger injection and full JSDoc typings
• Formatter: centralized all flags and readiness checks in private _formatEditor, enforced mutual-exclusivity of forced, isSaving and selectionOnly, and simplified command handlers to one-liners
• Bootstrap: dropped all prettier-eslint support/detection and streamlined startup to only require PrettierService

Performance

• JSON-RPC header parsing now uses Buffer.indexOf (no intermediate ASCII strings or regex), cutting allocations and GC pressure

Documentation

• Added comprehensive JSDoc for JSON-RPC constants/methods, PrettierService’s public API (format, hasConfig, getConfig) and private helpers
• Updated Help section to clarify that prettier-eslint is unsupported and direct ESLint should be used

3.5.37 – 2025‑05‑02

Added

• Plugin: prettier-plugin-toml Enables formatting support for .toml files.

• Help Section A dedicated Help Section has been added, accessible via Extensions → Prettier⁺ → Prettier⁺ Help.

3.5.36 – 2025‑05‑01

Fixed

• SQL Cursor Position

• Resolved an issue where formatting SQL files would reset the cursor to the start of the document. The extension now preserves the editor's current cursor position since prettier-plugin-sql always returns 0 as the cursor offset.

• Save Stall Prevention

• Fixed a bug where Nova could hang on save if the Prettier service wasn’t ready. Formatting now waits for proper initialization before attaching to save events.

Added

• Missing Runtime Detection
• A user-friendly error dialog now informs users if Node.js or npm is missing, with guidance on installing Node.js and updating the system PATH.

Improved

• Startup Resilience & Logging
• Prevented a potential infinite loop on configuration changes during startup.
• Logged both the extension and Nova versions at launch for easier debugging.
• Detected and cached the system npm --version for improved diagnostics.
• Renamed internal version helper for better clarity (isAtLeast → minNovaVersion).

3.5.35 - 2025-04-30

Fixed

• Lint Feedback: Fixed an issue where lint errors from Prettier were not forwarded to Nova’s issue panel. These are now correctly surfaced in-editor.

3.5.34 – 2025‑04‑30

Refactored

• Prettier Service, JSON-RPC, and Formatter Resilience

• Major internal rewrite of the JSON-RPC layer and service lifecycle

• json-rpc.js
  • Rewritten as a Transform stream for proper stream piping
  • Header normalization, improved framing via Buffer.indexOf
  • Enforces JSON-RPC 2.0 spec (validates jsonrpc, id, method)
  • Supports batch requests and emits multiple messages per chunk
  • Handles parse errors gracefully (no more hard exits on invalid input)
  • Respects back-pressure on writes using 'drain' events
• prettier-service.js
  • Service startup now awaits a handshake via notify('didStart')
  • Gracefully handles bootstrap errors via notify('startDidFail')
  • Centralized and simplified SIGTERM handler

• formatter.js

  • Ensures isReady before each call to prevent premature RPC use
  • Catches all IPC errors in format() and hasConfig() to avoid crashes

• Max Payload Size

• Parser now enforces a 32 MiB limit on incoming JSON-RPC payloads

• Lint Feedback

• Lint errors from Prettier are now passed through to Nova’s issue providers for in-editor feedback

Fixed

• Formatter Safety Checks
• Skips formatting if no syntaxKey could be determined
• Prevents writing undefined or empty output to avoid file erasure

3.5.33 – 2025‑04‑28

Improved

• Prettier service lifecycle and stability

• Optimized startup, shutdown, and crash recovery behavior

• Faster, more reliable restarts when configuration or project dependencies change

• Reduced unnecessary restarts on clean exits

• Debouncing and file watching

• Smarter debouncing with separate timing for file and settings changes

• Improved handling of external Prettier config files and custom config paths

• All watchers and listeners are now properly cleaned up on extension shutdown

• Logging

• Added detailed logs for service startup, shutdown timing, and crash detection
• Improved visibility into module loading failures

3.5.32 — 2025-04-27

Removed

• Eliminated the now-redundant write entitlement, since migrations fully leverage Nova’s config APIs.

3.5.31 - 2025-04-26

Added

• Added plugin: prettier-plugin-twig Enables formatting support for .twig files.

3.5.30 - 2025-04-25

Added

• SQL Dialect Detection Based on File Extension

• Maps known SQL-related extensions to supported sql-formatter dialects.

• Prioritizes longest-match extension resolution for accuracy (e.g., .mariadb.sql over .sql).
• Falls back to a generic 'sql' dialect when no match is found.
• Extracted extractPath into shared helpers for reuse across modules.
• Adds support for node-sql-parser dialect detection and compatibility.
• Normalizes incompatible dialects (e.g., 'tsql' → 'transactsql') before parser invocation.
• Falls back to 'sql' if the dialect is unsupported by node-sql-parser to ensure safe parsing.

• Centralizes dialect validation and normalization logic in sql.js for a clean formatter integration.

• Support for Nova's SQL Language Extension

• When Nova's SQL Language extension is installed, the provided syntax is now used for dialect detection instead of resolving via the URI.

3.5.29 – 2025‑04‑23

Added

• Added plugin: prettier-plugin-astro Enables formatting support for .astro files using the official Astro plugin.

• Expanded SQL extension detection Added more file extensions that trigger SQL formatting in Advanced Syntax Detection.

Changed

• Updated German translations

3.5.28 – 2025‑04‑22

Added

• Advanced Syntax Detection

Prettier⁺ no longer relies solely on Nova's reported syntax. It now intelligently determines the correct syntax based on file extensions—ensuring accurate formatting even when language extensions are not installed. This behavior can be disabled via the Advanced Syntax Detection setting. ⚠️ Language extensions are still recommended for best results.

Changed

• All bundled plugins are now enabled by default, except for prettier-plugin-tailwindcss, which remains optional.

3.5.27 - 2025-04-21

Added

• Added plugin: prettier-plugin-blade Enables formatting support for Laravel Blade templates.

3.5.26 – 2025‑04‑20

Added

• Added plugin: prettier-plugin-tailwindcss

Supports Tailwind class sorting in the following syntaxes:

• HTML
• HTML (EJS)
• HTML (Liquid)
• JavaScript
• JSX
• TSX
• TypeScript

Each language can be enabled or disabled individually in the extension or project settings.

• Added plugin: prettier-plugin-ejs
• Added plugin: prettier-plugin-ejs-tailwindcss
• Ignore list updated
• Added HTML (EJS), HTML (ERB) and TSX to the ignored syntaxes

Changed

• Prettier plugin list now sorted alphabetically
• Improves discoverability and consistency across plugin menus
• Refactored Prettier config sanitization
• Replaced manual JSON editing with Nova’s Config API
• Workspace settings are now safely updated using config.set()/config.remove() instead of modifying files directly

Refactored

• Prettier config loading logic
• Introduced loadPluginConfig() helper
• All plugin-specific config getters (getDefaultConfig, getPhpConfig, etc.) now use this helper
• Automatically filters out null/undefined options from config

3.5.25 – 2025‑04‑19

Added

• Added support for Liquid via prettier-plugin-liquid. Ensure the Liquid Extension is installed before enabling this plugin.

Fixed

• Included missing plugin options for:
• @prettier/prettier-plugin-php:
  • printWidth
  • tabWidth
  • useTabs
  • singleQuote
  • requirePragma
  • insertPragma
• @prettier/prettier-plugin-xml:
  • bracketSameLine
  • printWidth
  • singleAttributePerLine
  • tabWidth
• prettier-plugin-sql:
  • updated DB strings
• prettier-plugin-nginx:
  • printWidth
  • tabWidth
  • useTabs

3.5.24 – 2025‑04‑18

Removed

• Fully removed the deprecated Prettier option jsxBracketSameLine (this time for real…)

Added

• Full cleanup on extension deactivate
• Capture and store all Disposable handles (file watchers, commands, editor listeners, config observers, etc.)
• Introduce PrettierExtension.dispose() to:
  • Stop the Prettier subprocess
  • Dispose watchers, commands, save‑listeners, debounce timer, and config observers
• Reset all internal collections after disposal to avoid any stale references

Changed

• Add a hasStarted flag
• Prevents modulePathDidChange() from running during startup while config observers are being registered
• Ensures the resolver only kicks in after the extension has fully initialized

3.5.23 - 2025-04-17

Fixed

• Re-added jsxBracketSameLine ~for compatibility with plugins that still depend on it, despite upstream deprecation.~

3.5.22 - 2025-04-17

Added

• Full German localization
• All strings now translated — 100% complete via Weblate.

Removed

• Deprecated Prettier option: jsxBracketSameLine
• Removed per upstream deprecation.

Changed

• Switched to Babel AST for localization extraction

• Uses @babel/parser and @babel/traverse to extract nova.localize() calls.

• Supports multi-table output: calls with a third argument go into separate files (e.g. notification.json), others default to strings.json.

• Merges unified configuration and extension metadata into the default localization table.

• Proper logging

• Replaced raw console calls with log.info, log.warn, log.error, and log.debug.

• Debug logs now require “Log Debug Information” to be enabled.

• Refactored i18n

• Made remaining notification strings translatable.

3.5.21 - 2025-04-16

Changed

• Renamed the extension to Prettier⁺ — because it just looks better 😎
• updated prettier-plugin-sql to version 0.19.0
• updated rollup to version 4.4.0

3.5.20 - 2025-04-15

Added

• New command: Restart Prettier Service
• Available via Extensions > Prettier⁺ > Restart Prettier Service (⌃⇧⌘R)
• Allows manually restarting the Prettier service without restarting Nova

Changed

• Prettier service now restarts automatically
• Triggered on relevant module or settings changes:
  • running npm install (adds or removes Prettier)
  • setting/unsetting a global Prettier path
  • toggling the “Prefer Bundled Prettier” option
• No need to restart Nova anymore — Prettier⁺ will pick up the correct module on its own

Fixed

• Crash on rapid Prettier restarts
• Fixed a ReferenceError caused by incorrect access to _isStoppedPromise during service startup

3.5.19 - 2025-04-14

Note: Version 3.5.19 replaces 3.5.18, which was briefly released but promptly withdrawn after it failed to fully resolve the issue it aimed to fix.

Fixed

• Fixed a crash when formatting .vue files without a cursor set

3.5.17 - 2025-04-14

Added

• New option: Ignore Configuration

• When enabled, external configuration files (e.g. .prettierrc) are ignored

• The extension’s default settings and plugin options are always applied

• Custom Prettier configuration file support

• A custom configuration file can now be set in the extension or project settings

• This file takes precedence over any configuration files in the workspace

• Supersedes the Ignore Configuration option when both are used

• New option: Prefer Bundled Prettier

• Forces the extension to always use its bundled Prettier modules
• Has no effect when a custom module path is set

Fixed

• Respect project Prettier config when loading plugin options
• Plugin-specific options are now only applied when no project configuration file is found
• Prevents unintentional overrides from plugin defaults when using .prettierrc or similar files

3.5.16 - 2025-04-13

Added

• New Command: Format Document (Forced) — formats the current file even if its syntax is ignored or excluded via .prettierignore.

Changed

• Dismissing the warning shown when using Format Selection on unsupported syntaxes now disables the command for those syntaxes.
• Refined user-facing notifications for unsupported syntaxes and reset actions
• Internal: Refactored plugin and Prettier options handling

3.5.15 - 2025-04-12

Added

• Automatic package and patch management

• Implemented a module resolver to validate all dependencies declared in package.json

• Automatically runs npm install for any missing or outdated packages
• Applies patches using patch-package after every install

• Ensures patches are reapplied even when no packages are updated

• Syntax restriction for "Format Selection"

• Limited "Format Selection" to syntaxes supported by Prettier’s formatWithCursor: JavaScript, TypeScript, GraphQL, and Handlebars
• This restriction is due to upstream limitations in Prettier's cursor handling logic
• Displays a dismissible warning when attempting to format unsupported syntaxes
• Added command: Reset Syntax Warnings for Prettier⁺ to restore suppressed messages

Fixed

• Prevent crash in locStart / locEnd
• Added null-safe checks and fallback handling to avoid crashes when a node lacks location data
• This issue occurred in the XML plugin and previously prevented XML files from being formatted
• Prevents formatWithCursor from throwing TypeErrors on malformed AST nodes

3.5.14 - 2025-04-09

Note: This version supersedes 3.5.13, which was briefly published and then withdrawn due to a forgotten code update.

Changed

• Switched to Prettier’s native formatWithCursor for cursor preservation during formatting.
• Removed the custom diff-based cursor logic and fast-diff dependency.
• Cursor handling is now handled by Prettier directly, making the code simpler and more reliable.
• Editor now automatically scrolls to the restored cursor position after formatting.

Performance

• Formatting is now dramatically faster.
• A 49,395-character JSON file that previously took 30 seconds to format now completes in just 20 milliseconds.

3.5.12 - 2025-04-09

Fixed

• Corrected option handling for node-sql-parser: the extension previously used the wrong configuration key, which caused it to parse options for sql-formatter instead.

3.5.11 - 2025-04-08

Added

• Full German translation of the UI

Changed

• Removed the config key prettier.plugins.prettier-plugin-php.singleQuote (it duplicated prettier.default-config.singleQuote)
• Cleaned up descriptions for several options
• Database language names now follow official spelling

All UI elements have been translated into German. If you spot anything awkward or off, head over to Weblate and suggest improvements.

Chinese, French, and Japanese translations still need contributors — feel free to jump in! 😄

3.5.10 - 2025-04-06

Added

• Added support for formatting Java and .properties files
• Included prettier-plugin-java for Java source formatting
• Included prettier-plugin-properties for Java-style .properties configuration files

See the README for usage details.

3.5.9 - 2025-04-05

Changed

• workspaceConfig keys now use boolean values instead of enums:
• Enable → true
• Disable → false
• Global Default → key removed to fall back to global settings
• Compatibility with the original enum-based behavior is preserved
• Extension permission for filesystem access has been updated from readonly to readwrite to enable migration of project configuration files

Added

• Existing project configs (.nova/Configuration.json) are now automatically migrated to the new boolean format on startup
• A notification is shown if any project config values were changed during migration

3.5.8 - 2025-04-03

Changed

• Updated README and LICENSE

3.5.7 - 2025-04-02

Changed

• Restores the internal enum keys (Enable, Disable, Global Default) while keeping the original workspace config UI label values (Enabled, Disabled, Global Setting). This ensures compatibility with the original extension, allowing Prettier⁺ to be used as a drop-in replacement. Note: If you previously used custom values in your workspace config, you may need to update them manually.

3.5.6 - 2025-04-02

Added

• activationEvents: Prettier⁺ now uses conditional activation. It won’t run unless it finds a supported config file (like .prettierrc) in the project root.
• Localization groundwork: Initial translation support has been implemented. Translations can be contributed via Weblate

Fixed

• Plugin option mapping: NGINX and SQL plugin options (specifically for node-sql-parser) were being mishandled—this has now been corrected.

3.5.5 - 2025-04-01

Added

• added new Prettier option: objectWrap

Changed

• build: generate config from unified source

3.5.4 - 2025-04-01

Fixed

• Fix incorrect switch cases in getWorkspaceConfig()

Added

• Added Acknowledgments to README.md

3.5.3 - 2025-03-31

Changed

• Updated versioning scheme to reflect new format
• Changed repository and issues URLs

3.1.1 - 2025-03-31

This extension has been forked from the original extension.

Changed

• updated bundled Prettier module to 3.4.1
• updated bundled node modules to their latest version
• all Global Settings are now available in the Project settings (including ignored Syntax)
• renamed Global Default to Global Setting
• renamed Enable/Disable to Enabled/Disabled
• add placeholder values
• ENUMS are displayed as drop-downs instead of radio buttons
• all Titles are now in Title Case
• updated the links for Prettier Options
• updated descriptions
• added named exports to rollup
• JS files are now minified during extension build
• log Prettier options to the console
• don't log do extension console by default
• bundled plugins are loaded dynamically
• set proper extension category: commands, formatter & keybindings

Added

• @rollup/plugin-terser to minify the extensions JS
• Prettier option singleAttributePerLine
• Prettier option embeddedLanguageFormatting
• @prettier/plugin-xml for formatting XML files
• added prettier-plugin-sql for formatting SQL files
• plugins can be configured in the extension/project setting
• bundled plugins can be enabled/disabled individually
• added SQL and XML to the ignored syntax

Fixed

• PHP Plugin was bundled but never used

Deprecated

• JSX Brackets (will be removed in a future version)

Known Issues

When adding params or paramsType to the sql-formatter option, the user must click outside the text filed for the changes to be applied. Will be fixed in a future release.

2.6.0 - 2023-05-01

Added

• Try formatting based on the syntax selected in Nova if Prettier can't determine the parser
• Add support for formatting unsaved TSX and HTML (ERB) files

2.5.1 - 2023-04-17

Fixed

• Fixes extension crashing when opening a file outside a workspace, or a remote file

2.5.0 - 2023-04-16

Added

• Added support for finding Prettier installed through yarn and pnpm, etc. (only if node_modules is used)
• Look for Prettier installations in the project's parent folder before falling back to the bundled Prettier

Fixed

• Fixes prettier not being able to find plugins installed in the project folder

2.4.0 - 2023-04-10

Added

• Changes to Prettier configuration in .prettierrc and package.json are now applied automatically

Changed

• Updated bundled Prettier to 2.8.7
• Updated bundled Prettier PHP plugin to 0.19.4

Fixed

• Fixes Format with Prettier following format on save Ignore documents without Prettier configuration file configuration value
• Fixes a possible error when restarting the Prettier process

2.3.0 - 2021-05-19

Added

• Added global and project settings to override the Prettier module path
• Added (experimental) support for prettier-eslint

Changed

• Errors occurring while loading the Prettier module will now be logged with message and stack trace

2.2.2 - 2021-05-10

Changed

• Revert to keeping cursor position in the extension

2.2.1 - 2021-02-21

Changed

• Use Nova's new built-in way of keeping the cursor position/selection after formatting

2.2.0 - 2021-02-04

Added

• Added Save Without Formatting command

Changed

• Loading Prettier may be retried once after a small delay instead of immediately showing an error
• Updated bundled Prettier to 2.2.1
• Updated bundled Prettier PHP plugin to 0.16.1

2.1.0 - 2020-11-25

Changed

• Updated bundled Prettier PHP plugin to 0.16.0
• Updated bundled Prettier to 2.2.0

Fixed

• Fixes project Prettier not getting found when using npm v7.0.0

2.0.0 - 2020-11-03

Added

• Added Format selection command
• All selections/cursors are now maintained after formatting
• A warning is now shown if a document uses an unsupported syntax when formatting manually

Changed

• (Breaking) Removed compatibility mode
• Renamed Format with Prettier to Format and moved it into a submenu
• Nova will now wait for formatting before saving instead of saving twice
• Formatting a file while the extension is installing Prettier will be delayed instead of getting ignored entirely
• Disabling debug logging now also disables logging about finding Prettier

Fixed

• Fixes project Prettier not getting found in some cases

1.8.2 - 2020-10-26

Fixed

• Fixes last line of code getting duplicated in some cases
• Fixes position of column indicator offset by -1
• Fixes a possible error when trying to check Prettier version
• Fixes (PHP) syntax errors without a column indicator causing an error
• Fixes (Twig) syntax errors with a double column indicator causing an error

1.8.1 - 2020-10-23

Added

• Support syntax errors thrown by prettier-plugin-twig-melody

1.8.0 - 2020-10-18

Added

• Added preferences to set default Prettier configuration globally and per-project.
• Added preference (global and per-project) to ignore files for which no Prettier configuration file can be found when formatting on save.
• Added preference (global and per-project) to ignore remote files when formatting on save.
• Added preference to disable debug logging (errors are always logged).

Changed

• Added an extra warning about future compatibility mode removal

Fixed

• Fixes extension failing to parse NPM output and failing to start when no project Prettier is installed.

1.7.1- 2020-10-09

Fixed

• Actually fixes parser overrides in .prettierrc file getting ignored.

1.7.0 - 2020-10-08

Changed

• Only use Prettier available in the project if it's a direct project dependency.
• Take .editorconfig into account when determining formatting configuration.
• The Format with Prettier command now ignores the .prettierignore file.

Fixed

• Fixes parser overrides in .prettierrc file getting ignored.
• Fixes formatting an unsaved file outside of a workspace causing an error.
• Fixes document text getting mixed up if changes are made during formatting.

1.6.1 - 2020-10-05

Added

• Added global setting to disable Format on save for specific syntaxes.
• Included PHP plugin with bundled Prettier.
• More events are logged to the extension console.

Changed

• Plugin support is now enabled by default, but can be disabled when errors occur.
• Selected text now remains selected after formatting (doesn't support multiple selections / cursors).
• Folded code will now remain folded unless formatting changes it.
• Improved formatting speed.
• The Format with Prettier command is now available for all syntaxes, so it works with plugins.
• Show syntax errors from PHP plugin inline.
• Don't show error when trying to format a file that has no parser available.

Fixed

• Fixes an error trying to log errors occurring while looking up configuration.

1.5.2 - 2020-10-03

Changed

• Show notification about any unhandled errors during formatting.

Fixed

• Fixes syntax errors preventing formatting no longer getting reported.
• Fixes issues on older macOS releases.

1.5.1 - 2020-09-27

Changed

• When formatting on save, automatically save the file again if Nova thought formatting took too long and saved the unformatted version.

Fixed

• Fixes unnecessary document updates when it's already properly formatted.

1.5.0 - 2020-09-26

Added

• Support for Prettier plugins (requires enabling Run Prettier in a separate process (experimental)).

Changed

• Improved performance when formatting large files (requires enabling Run Prettier in a separate process (experimental)).
• Stop formatting PHP, unless the PHP plugin is used.

1.4.0 - 2020-09-25

Added

• Set a default keyboard shortcut for Format with Prettier command: ⌥⇧F.
• Added a global Format on save preference that can be overridden by project preferences.
• Support formatting of HTML in PHP files.

Changed

• Fall back to bundled Prettier when loading the project's Prettier installation fails.

Fixed

• Fixes files opened after disabling formatting on save getting formatted on save.

1.3.0 - 2020-09-21

Added

• Support formatting of files in non-project windows.
• Support working on the Prettier repository.
• Automatically update the bundled installation of Prettier if the extension includes a new version.

Changed

• (Breaking) Updated bundled Prettier to 2.1.2.

1.2.1 - 2020-09-17

Added

• Support formatting of new files that have never been saved.
• Include CSS in supported syntaxes.

Changed

• Don't require editor focus for the Format with Prettier to be available.
• Log non-syntax errors from Prettier to the extension console properly.
• Include stack trace with errors logged in the extension console.

1.2.0 - 2020-08-17

Added

• Added a warning with help when Prettier (and NPM) can't be found.

1.1.0 - 2020-06-15

Added

• Use Prettier installed in the project's node_modules. If none is available the extension falls back to the bundled Prettier.
• Automatically find and load parsers provided by Prettier.

1.0.0 - 2020-06-12

Added

• Use .prettierignore to determine which files to format (.prettierignore needs to be in the project root).
• Added a warning when an error occurs while looking up the Prettier configuration for a file.

Changed

• (Breaking) Updated to Prettier 2.0.5.

0.2.0 - 2020-02-29

Added

• Don't include prettier in extension, but install when activating.

0.1.0 - 2020-01-31

Added

• Initial release.

MIT License

Copyright (c) 2023 Alexander Weiss, 2025 Toni Förster

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Table of Contents

• General
• Prettier Module Resolution
• Override Behavior Precedence
• Settings Precedence
• Configuration
• Configuration Methods
• Configuration Precedence
• Ignoring Files
• Working with Remote Files
• Troubleshooting
• Formatting not Working
• Resetting the Extension
• Custom Prettier Forks
• Prettier-Eslint (Not Supported)

General

Prettier⁺ includes a built-in version of Prettier with support for common plugins like prettier-plugin-php, prettier-plugin-xml, prettier-plugin-sql, and more.

This bundled version is the default and recommended way to use Prettier⁺.

Prettier Module Resolution

However, Prettier⁺ will automatically prefer another version if found:

1. Global Prettier

If you've set General → Prettier Module to a global install in the Extension Settings or Project Settings, the globally installed Prettier will be used.

To install globally:

bash npm install -g prettier

1. Project-local Prettier

If your project contains a prettier installation in node_modules, it will be used automatically.

Override Behavior Precedence

1. Global Prettier

   If the General → Prettier Module path is set, the globally installed Prettier is used.

2. Project‑local Prettier

   Otherwise, if a prettier installation is found in your project’s node_modules, that version is used.

3. Bundled Prettier (Preferred)

   If neither a global path nor a project‑local install is detected — or if you enable General → Prefer Bundled Prettier under Extension Settings or Project Settings — the built‑in Prettier⁺ version is used.

   Enabling Prefer Bundled Prettier does not override a global path setting.

Settings Precedence

In general, settings changed in Project Settings will override their counterpart in the Extension Settings.

Configuration

Prettier⁺ can be configured either via the UI or with any of Prettier’s standard config files.

Supported formats include:

• .prettierrc, .prettierrc.json, .prettierrc.yml, .prettierrc.js
• prettier.config.js, prettier.config.cjs
• package.json ("prettier" field)

All known Prettier config extensions are supported — including .json5, .toml, .ts, .cjs, .mjs, .cts, and .mts.

Configuration Methods

You can configure Prettier⁺ in three ways:

• Using a custom config file

Set the path in either Project Settings or Extension Settings under General → Prettier Configuration.

• Per-project configuration

Searches recursively, so configs in subfolders (e.g., monorepos) are detected. Prettier⁺ will look for supported config files in the project.

• Extension or project settings

Options set in the Nova UI will be used if no config files are found.

Configuration Precedence

1. If a custom configuration file is set, it always takes precedence — even if other config files exist.
2. If no global config is set, Prettier⁺ uses the nearest project-local configuration file.
3. If no config files are found, the extension falls back to the options set in Nova’s Extension or Project settings.

If Ignore Configuration Files is enabled under: General → Ignore Configuration Files settings, Prettier⁺ will always use the Nova UI options — unless a custom config file is set, which still takes priority.

Ignoring Files

Prettier⁺ respects .prettierignore files and ignored syntaxes. You can also disable formatting for a specific file by adding a comment:

// prettier-ignore

You can also disable Format on Save for:

• Remote documents
• Files without a detected configuration file
• Specific syntaxes

via the “Ignore” toggles in the Extension or Project Settings.

Working with Remote Files

Prettier⁺ fully supports formatting remote files by default when using Nova's built-in remote editing.

However, remote files do not support local configuration discovery, including:

• .prettierrc, prettier.config.js, or other config files
• .prettierignore files

As a result, Prettier⁺ will use its default settings, made in the Extensions Settings, when formatting remote files, and all files are included regardless of ignore rules in .prettierignore.

⚠️ Remote formatting works, but no config or ignore files are applied.

Troubleshooting

Formatting not Working

• Ensure the file type is supported and not ignored.
• Enable logging and check the Extension Console for any errors reported by Prettier⁺.
• Try restarting the Prettier Service from the menu: Extensions → Prettier⁺ → Restart Prettier Service
• Try using your project’s own Prettier version or reloading the workspace.
• Reset the extension if dependencies appear broken.

Resetting the Extension

To reinstall the bundled Prettier version (e.g. if auto-installation failed or dependencies are broken):

1. Open Nova’s built-in Terminal: Extensions → Local Terminal.
2. Run the following commands:

bash cd "~/Library/Application Support/Nova/Extensions/stonerl.prettier" rm -rf node_modules npm install

Custom Prettier Forks

   Prettier⁺ supports using forked versions of Prettier as long as they export a
   compatible API (e.g. `format`, `resolveConfig`, `getFileInfo`).

   > ⚠️ Use at your own risk — compatibility with nonstandard Prettier builds may vary.

Prettier-Eslint (Not Supported)

   Prettier⁺ does not support `prettier-eslint` or similar wrappers.

   If you rely on ESLint formatting rules, configure ESLint separately and run it
   using a dedicated formatter (e.g., via a Nova ESLint extension or your CI setup).

   Prettier⁺ focuses solely on Prettier and its plugin ecosystem.