English

简体中文

English

简体中文

Appearance

app dev ​

The app dev command launches a local development environment, enabling real-time preview and testing. It automates app building, environment setup, and store integration.

Syntax ​

bash
genstore app dev [options]

Use cases ​

  • Local Development: Preview changes and validate functionality in real-time.
  • Extension Testing: Test extensions in development stores for compatibility.
  • Configuration Validation: Preview changes before deployment to reduce risks.

TIP

  • Must have store owner or staff access.
  • Initial setup creates required staff accounts.
  • Configuration persists between sessions.
  • Run with --reset to reconfigure from scratch.

Implementation guide ​

Run app dev after initialization to begin. The system guides you through:

  • Link existing app (--client-id) or create new one.
  • Connect to your partner account/organization.

Configure development store ​

  • Choose development store (auto-selected if only one exists).
  • Complete app installation via provided link

Set up environment ​

  • Configure development tunnel (--tunnel-url for custom setup).
  • Configure app URL in partner dashboard.
  • Option to manually configure preview URL.

Configure features ​

  • Enable extension preview.
  • Configure credentials and access scope.
  • Set up Admin API support.

Launch services ​

  • Build app and extensions.
  • Initialize local server.
  • Set up preview URL.

Configuration options ​

The following configuration options are available:

bash
--client-id <value>
  • Environment variable: GENSTORE_FLAG_CLIENT_ID
  • Use: Specify an existing Genstore app's client ID for the new project.
  • Effect: Use this option bypasses the interactive app selection prompt.
bash
--reset
  • Environment variable: GENSTORE_FLAG_RESET
  • Use: Clear saved settings.
  • Effect: Fresh configuration
bash
--tunnel-url <value>
  • Environment variable: GENSTORE_FLAG_TUNNEL_URL
  • Use: Set custom tunnel URL
  • Format: "https://my-tunnel-url:port"
bash
-c, --config <value>
  • Environment variable: GENSTORE_FLAG_APP_CONFIG
  • Use: Specify config name.
  • Effect: Environment-specific generation.

Examples ​

Use the client ID option

bash
genstore app dev --client-id your-client-id

Use environment variable

bash
export GENSTORE_FLAG_CLIENT_ID=your-client-id
genstore app dev