summaryrefslogtreecommitdiff
path: root/.changeset/gentle-cobras-wash.md
diff options
context:
space:
mode:
Diffstat (limited to '.changeset/gentle-cobras-wash.md')
-rw-r--r--.changeset/gentle-cobras-wash.md17
1 files changed, 17 insertions, 0 deletions
diff --git a/.changeset/gentle-cobras-wash.md b/.changeset/gentle-cobras-wash.md
new file mode 100644
index 000000000..1a9245524
--- /dev/null
+++ b/.changeset/gentle-cobras-wash.md
@@ -0,0 +1,17 @@
+---
+'astro': minor
+---
+
+Adds the `astro preferences` command to manage user preferences. User preferences are specific to individual Astro users, unlike the `astro.config.mjs` file which changes behavior for everyone working on a project.
+
+User preferences are scoped to the current project by default, stored in a local `.astro/settings.json` file. Using the `--global` flag, user preferences can also be applied to every Astro project on the current machine. Global user preferences are stored in an operating system-specific location.
+
+```sh
+# Disable the dev overlay for the current user in the current project
+npm run astro preferences disable devOverlay
+# Disable the dev overlay for the current user in all Astro projects on this machine
+npm run astro preferences --global disable devOverlay
+
+# Check if the dev overlay is enabled for the current user
+npm run astro preferences list devOverlay
+```