Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
62 commits
Select commit Hold shift + click to select a range
653f850
Group CLI crash reports on structured error signals
stephanie-shopify Jun 23, 2026
09e3ba0
Drop unused export on ErrorGroupingSignals interface
stephanie-shopify Jun 23, 2026
a9d2115
Clarify filesystem testing guidance
alfonso-noriega Jun 23, 2026
c88c703
Make metadata timer tests deterministic
alfonso-noriega Jun 24, 2026
8e0dc34
Address review: robust GraphQL code scanning, single grouping resolve…
stephanie-shopify Jun 29, 2026
f0fc5fd
Fix lint: prettier multi-line returns + jsdoc indentation
stephanie-shopify Jun 29, 2026
41879bf
Regenerate admin types: add THEME_CONTEXTUALIZATION_NOT_COMPATIBLE_WI…
stephanie-shopify Jun 29, 2026
fadcffa
Use preview identity for store open analytics
alfonso-noriega Jul 6, 2026
983da3c
Remove preview store user ID prefix
alfonso-noriega Jul 6, 2026
a0ba941
Address error grouping review comments
stephanie-shopify Jul 6, 2026
3340ff3
Merge pull request #7917 from Shopify/06-24-make_metadata_timer_tests…
alfonso-noriega Jul 6, 2026
9d5b46d
Merge pull request #7905 from Shopify/06-23-clarify_filesystem_testin…
alfonso-noriega Jul 6, 2026
26d9b4f
Fix error grouping formatting
stephanie-shopify Jul 6, 2026
77f8eca
Handle missing theme write access
mbarak Jun 27, 2026
9b754a9
Merge pull request #7941 from Shopify/vault-31608-graphql-catchall
mbarak Jul 6, 2026
5fc5fda
Merge pull request #7901 from Shopify/fix/error-grouping-structured
stephanie-shopify Jul 6, 2026
d6d6a17
Merge pull request #8005 from Shopify/store-open-preview-identity
alfonso-noriega Jul 7, 2026
775e915
Merge pull request #8007 from Shopify/remove-preview-user-prefix
alfonso-noriega Jul 7, 2026
149fcc8
Stop tracking generated docs interfaces
isaacroldan Jul 7, 2026
6c6cc2a
Add auth-alias flag
isaacroldan Jul 8, 2026
1897aae
Merge pull request #8025 from Shopify/ignore-generated-doc-interfaces
isaacroldan Jul 8, 2026
2424f5e
Remove direct auth session option
isaacroldan Jul 8, 2026
d871fba
Remove deprecated 1P dev mode
isaacroldan Jul 7, 2026
927fd35
Remove deprecated draftable extension process
isaacroldan Jul 7, 2026
a4faa04
Stabilize config link e2e prompt input
isaacroldan Jul 7, 2026
6831cbf
Bound e2e app deletion lookup time
isaacroldan Jul 7, 2026
52a968f
Remove draftable extension leftovers
isaacroldan Jul 8, 2026
84ba3cf
Remove dev session support branching
isaacroldan Jul 7, 2026
7d1f4f0
Remove unused developer preview helpers
isaacroldan Jul 7, 2026
44cfd9a
Remove legacy developer preview concepts
isaacroldan Jul 7, 2026
cd3114e
Remove store search support flag
isaacroldan Jul 7, 2026
8e83c2e
Remove atomic deployment support flag
isaacroldan Jul 7, 2026
6619d84
Consolidate agent instructions into AGENTS.md
amcaplan Jul 2, 2026
a4aadfa
Make approach-outlining proportional to task complexity
amcaplan Jul 8, 2026
7bc65df
Merge pull request #7984 from Shopify/update-agent-guidelines
amcaplan Jul 8, 2026
68e5391
Merge pull request #8026 from Shopify/codex/auth-alias-command-context
isaacroldan Jul 9, 2026
9bafc2f
Allow app config link to target config by client ID
gonzaloriestra May 25, 2026
0348f02
Fix non-UUID identifier helper call
isaacroldan Jul 8, 2026
c77729f
Remove dashboard managed extension support flag
isaacroldan Jul 8, 2026
b9b95cc
Remove unused extension creation surface
isaacroldan Jul 7, 2026
838286a
Remove bundled UI extensions dev console
isaacroldan Jul 8, 2026
b1f401a
Merge pull request #8017 from Shopify/remove-shopify-cli-1p-dev
isaacroldan Jul 9, 2026
01039e3
Remove stack changesets
isaacroldan Jul 9, 2026
16608bd
Merge pull request #8018 from Shopify/remove-draftable-extension-process
isaacroldan Jul 9, 2026
ae589ea
Merge pull request #8019 from Shopify/remove-supports-dev-sessions
isaacroldan Jul 9, 2026
2cfb495
Merge pull request #8020 from Shopify/remove-legacy-dev-preview-concepts
isaacroldan Jul 9, 2026
5a99ef3
Merge pull request #8021 from Shopify/remove-supports-store-search
isaacroldan Jul 9, 2026
e8263bb
Merge pull request #8022 from Shopify/remove-supports-atomic-deployments
isaacroldan Jul 9, 2026
2cb776e
Merge pull request #7630 from Shopify/cli-interactivity/app-config-link
gonzaloriestra Jul 9, 2026
8cc2366
Merge pull request #8023 from Shopify/remove-create-extension-client-…
isaacroldan Jul 9, 2026
5068c89
Merge pull request #8033 from Shopify/remove-ui-extensions-dev-console
isaacroldan Jul 9, 2026
c1dfed4
Merge pull request #8034 from Shopify/remove-dashboard-managed-extens…
isaacroldan Jul 9, 2026
0f46e88
Unhide store commands for public release
amcaplan Jul 1, 2026
d2cf7dd
Drop outdated store create preview visibility test
amcaplan Jul 2, 2026
ffeb971
Update dev docs
amcaplan Jul 2, 2026
787ce87
Unify store create preview country env var to SHOPIFY_FLAG_STORE_COUNTRY
amcaplan Jul 9, 2026
ccf34f2
Add --country flag to store create dev (validation/scaffolding only)
amcaplan Jun 28, 2026
f006001
Send country code when creating a dev store
amcaplan Jul 1, 2026
eb04bab
Validate --country in flag parse to share logic across commands
amcaplan Jul 8, 2026
98f1d79
Remove decisions files
amcaplan Jul 8, 2026
3bdbf2e
Consolidate --country into a single shared flag constant
amcaplan Jul 8, 2026
cca2e79
Always render Admin row with N/A fallback in dev store success output
amcaplan Jul 8, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
5 changes: 5 additions & 0 deletions .changeset/app-config-link-flags.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
'@shopify/app': patch
---

Add `--client-id` and `--file-name` options to `app config link`.
7 changes: 7 additions & 0 deletions .changeset/auth-alias-command-context.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
'@shopify/app': patch
'@shopify/cli-kit': patch
'@shopify/theme': patch
---

Allow app and theme commands to authenticate with a Shopify account alias without changing the current CLI session.
5 changes: 5 additions & 0 deletions .changeset/friendly-theme-create-access-error.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
'@shopify/cli-kit': patch
---

Show a friendly error when theme creation is denied by missing theme write access
6 changes: 6 additions & 0 deletions .changeset/unhide-store-auth-list.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
'@shopify/cli': minor
'@shopify/store': minor
---

Add `shopify store auth list` to list stores authenticated on this machine with `shopify store auth`.
6 changes: 6 additions & 0 deletions .changeset/unhide-store-create-preview.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
'@shopify/cli': minor
'@shopify/store': minor
---

Add `shopify store create preview` to create a preview Shopify store with no existing account required.
6 changes: 6 additions & 0 deletions .changeset/unhide-store-list.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
'@shopify/cli': minor
'@shopify/store': minor
---

Add `shopify store list` to list stores in a Shopify organization.
6 changes: 6 additions & 0 deletions .changeset/unhide-store-open.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
'@shopify/cli': minor
'@shopify/store': minor
---

Add `shopify store open` to open a store's storefront in your default web browser.
2 changes: 0 additions & 2 deletions .claude/CLAUDE.md
Original file line number Diff line number Diff line change
@@ -1,3 +1 @@
See @../AGENTS.md for repository-specific agent instructions.
See @../.cursor/rules/base.mdc for information on your desired behavior.
See @../.cursor/rules/docs.mdc for details on Shopify CLI architecture and conventions.
38 changes: 1 addition & 37 deletions .cursor/rules/base.mdc
Original file line number Diff line number Diff line change
Expand Up @@ -3,40 +3,4 @@ description:
globs:
alwaysApply: true
---
As a Principal Developer, the highest ranking engineer at our company, you are tasked with creating clear, readable code in Typescript. You use the latest version of all of these technologies, and follow their best practices and conventions.

When responding to questions, follow the Chain of Thought method. First, outline a detailed plan step by step in great detail, then outline that plan in pseudocode, then confirm it, then write the code, and rewrite the code for concision and readability.

You carefully provide accurate, factual, thoughtful answers, and are a genius at reasoning; but you always admit when you don't know the answer.

Remember the following important mindset when providing code, in the following order:
- Adherance to conventions and patterns in the rest of the codebase
- Simplicity
- Readability
- Testability
- Explicitness
- Beginner-friendly

Adhere to the following guidelines in your code:
- Follow the user's requirements carefully and to the letter.
- Fully implement all requested functionality
- Leave no TODOs, FIXMEs, placeholders or missing pieces.
- Always consider the experience of a developer who will be reading your code.
- Use comments to explain why you are doing something in a certain way, if it is not obvious. If unsure, leave a comment.
- Employ descriptive, human-readable variable and function/const names.
- Prefer writing in a functional style, producing pure functions that do not cause side effects.
- The codebase is strictly linted; follow the existing code style to ensure consistency.
- If the generated code would fail a lint check, refactor the code until it no longer fails the lint check.
- Search hard to find an existing function where possible. These are often in the @shopify/cli-kit library.
- Be sure to reference file names
- Be concise. Minimize any prose other than code.
- If you think there might not be a correct answer, say so. If you do not know the answer, say so instead of guessing.
- In tests, always avoid mocking the filesystem. Use real files and directories, in temporary directories if needed.
- In tests, prefer to have as little shared state between tests as possible. Avoid beforeAll and afterAll.

Changesets:
- Add a changeset only when the change is user-facing and ready to appear in public changelogs and release notes.
- Add changesets for visible CLI behavior changes, bug fixes users will notice, public API or schema changes, and new or changed commands, flags, prompts, output, or error behavior.
- Keep changeset summaries short: one line maximum.
- Do not add changesets for tests, refactors, linting, CI, internal tooling, or generated files with no user-visible impact.
- If the change is not ready to be public, do not add a changeset.
See [AGENTS.md](mdc:AGENTS.md) for repository-specific agent instructions, coding guidelines, changeset conventions, and further reading.
30 changes: 0 additions & 30 deletions .cursor/rules/docs.mdc

This file was deleted.

8 changes: 1 addition & 7 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -180,11 +180,11 @@ eslint-report.json

# Generated docs
docs/api
docs-shopify.dev/commands/interfaces/

vite.config.ts.timestamp*

# from nested gitignores
packages/app/assets/dev-console
packages/ui-extensions-server-kit/*.d.ts
packages/ui-extensions-server-kit/!typings.d.ts
packages/ui-extensions-server-kit/index.*
Expand All @@ -195,12 +195,6 @@ packages/store/src/cli/api/graphql/business-platform-organizations/organizations
packages/ui-extensions-test-utils/*.d.ts
packages/ui-extensions-test-utils/!typings.d.ts
packages/ui-extensions-test-utils/dist
packages/ui-extensions-dev-console/*.js
packages/ui-extensions-dev-console/*.d.ts
packages/ui-extensions-dev-console/!typings.d.ts
packages/ui-extensions-dev-console/.eslintrc.js
packages/ui-extensions-dev-console/css-transform.js
packages/ui-extensions-dev-console/dist
packages/cli-kit/src/cli/api/graphql/*/*_schema.graphql
packages/organizations/src/cli/api/graphql/*/*_schema.graphql
packages/store/src/cli/api/graphql/*/*_schema.graphql
Expand Down
62 changes: 62 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,38 @@
# Agent Instructions

As a Principal Developer, the highest ranking engineer at our company, you are tasked with creating clear, readable code in TypeScript. You use the latest version of all of these technologies, and follow their best practices and conventions.

Match your planning to the complexity of the task. For anything beyond a small or obvious change, outline your intended approach before writing code — which files you'll touch and the shape of the solution — so it can be checked before you commit to an implementation. Keep this to a few sentences or bullets. For trivial changes, skip straight to the implementation.

You carefully provide accurate, factual, thoughtful answers, and are a genius at reasoning; but you always admit when you don't know the answer.

Remember the following important mindset when providing code, in the following order:
- Adherence to conventions and patterns in the rest of the codebase
- Simplicity
- Readability
- Testability
- Explicitness
- Beginner-friendly

## Guidelines

Adhere to the following guidelines in your code:
- Follow the user's requirements carefully and to the letter.
- Fully implement all requested functionality
- Leave no TODOs, FIXMEs, placeholders or missing pieces.
- Always consider the experience of a developer who will be reading your code.
- Use comments to explain why you are doing something in a certain way, if it is not obvious. If unsure, leave a comment.
- Employ descriptive, human-readable variable and function/const names.
- Prefer writing in a functional style, producing pure functions that do not cause side effects.
- The codebase is strictly linted; follow the existing code style to ensure consistency.
- If the generated code would fail a lint check, refactor the code until it no longer fails the lint check.
- Search hard to find an existing function where possible. These are often in the @shopify/cli-kit library.
- Be sure to reference file names
- Be concise. Minimize any prose other than code.
- If you think there might not be a correct answer, say so. If you do not know the answer, say so instead of guessing.
- In tests, always avoid mocking the filesystem. Use real files and directories, in temporary directories if needed.
- In tests, prefer to have as little shared state between tests as possible. Avoid beforeAll and afterAll.

## Changesets

Add a changeset only when the change is user-facing and ready to appear in public changelogs and release notes.
Expand All @@ -11,3 +44,32 @@ Keep changeset summaries short: one line maximum.
Do not add changesets for tests, refactors, linting, CI, internal tooling, or generated files with no user-visible impact.

If the change is not ready to be public, do not add a changeset.

## Further reading

### CLI

- [docs/README.md](docs/README.md)
- [docs/cli/architecture.md](docs/cli/architecture.md)
- [docs/cli/conventions.md](docs/cli/conventions.md)
- [docs/cli/cross-os-compatibility.md](docs/cli/cross-os-compatibility.md)
- [docs/cli/debugging.md](docs/cli/debugging.md)
- [docs/cli/eslint-rules.md](docs/cli/eslint-rules.md)
- [docs/cli/faq.md](docs/cli/faq.md)
- [docs/cli/get-started.md](docs/cli/get-started.md)
- [docs/cli/naming-conventions.md](docs/cli/naming-conventions.md)
- [docs/cli/performance.md](docs/cli/performance.md)
- [docs/cli/testing-strategy.md](docs/cli/testing-strategy.md)
- [docs/cli/troubleshooting.md](docs/cli/troubleshooting.md)

### CLI kit

- [docs/cli-kit/command-guidelines.md](docs/cli-kit/command-guidelines.md)
- [docs/cli-kit/errors.md](docs/cli-kit/errors.md)
- [packages/cli/README.md](packages/cli/README.md)

### UI kit

- [docs/cli-kit/ui-kit/contributing.md](docs/cli-kit/ui-kit/contributing.md)
- [docs/cli-kit/ui-kit/guidelines.md](docs/cli-kit/ui-kit/guidelines.md)
- [docs/cli-kit/ui-kit/readme.md](docs/cli-kit/ui-kit/readme.md)
48 changes: 0 additions & 48 deletions docs-shopify.dev/commands/interfaces/app-build.interface.ts

This file was deleted.

This file was deleted.

Loading
Loading