--- title: app dev description: >- Builds and previews your app on a development store, and watches for changes. [Read more about testing apps locally](/docs/apps/build/cli-for-apps/test-apps-locally). api_name: shopify-cli source_url: html: 'https://shopify.dev/docs/api/shopify-cli/app/app-dev' md: 'https://shopify.dev/docs/api/shopify-cli/app/app-dev.md' --- # app devcommand Builds and previews your app on a development store, and watches for changes. [Read more about testing apps locally](https://shopify.dev/docs/apps/build/cli-for-apps/test-apps-locally). ## Flags The following flags are available for the `app dev` command: * \--checkout-cart-url \ string env: SHOPIFY\_FLAG\_CHECKOUT\_CART\_URL Resource URL for checkout UI extension. Format: "/cart/{productVariantID}:{productQuantity}" * \--client-id \ string env: SHOPIFY\_FLAG\_CLIENT\_ID The Client ID of your app. * \--localhost-port \ string env: SHOPIFY\_FLAG\_LOCALHOST\_PORT Port to use for localhost. * \--no-color env: SHOPIFY\_FLAG\_NO\_COLOR Disable color output. * \--no-update env: SHOPIFY\_FLAG\_NO\_UPDATE Skips the Partners Dashboard URL update step. * \--notify \ string env: SHOPIFY\_FLAG\_NOTIFY The file path or URL. The file path is to a file that you want updated on idle. The URL path is where you want a webhook posted to report on file changes. * \--path \ string env: SHOPIFY\_FLAG\_PATH The path to your app directory. * \--reset env: SHOPIFY\_FLAG\_RESET Reset all your settings. * \--skip-dependencies-installation env: SHOPIFY\_FLAG\_SKIP\_DEPENDENCIES\_INSTALLATION Skips the installation of dependencies. Deprecated, use workspaces instead. * \--subscription-product-url \ string env: SHOPIFY\_FLAG\_SUBSCRIPTION\_PRODUCT\_URL Resource URL for subscription UI extension. Format: "/products/{productId}" * \--theme-app-extension-port \ string env: SHOPIFY\_FLAG\_THEME\_APP\_EXTENSION\_PORT Local port of the theme app extension development server. * \--tunnel-url \ string env: SHOPIFY\_FLAG\_TUNNEL\_URL Use a custom tunnel, it must be running before executing dev. Format: "". * \--use-localhost env: SHOPIFY\_FLAG\_USE\_LOCALHOST Service entry point will listen to localhost. A tunnel won't be used. Will work for testing many app features, but not those that directly invoke your app (E.g: Webhooks) * \--verbose env: SHOPIFY\_FLAG\_VERBOSE Increase the verbosity of the output. * -c, --config \ string env: SHOPIFY\_FLAG\_APP\_CONFIG The name of the app configuration. * -s, --store \ string env: SHOPIFY\_FLAG\_STORE Store URL. Must be an existing development or Shopify Plus sandbox store. * -t, --theme \ string env: SHOPIFY\_FLAG\_THEME Theme ID or name of the theme app extension host theme. ### Examples * #### app dev ##### app dev ```bash shopify app dev [flags] ```