Skip to content

Create app via Genstore CLI

Third-party developers can extend Genstore's functionality using the CLI tool to build applications that offer merchants richer solutions. This guide walks you through creating your first application.

The Partner Platform provides two ways to create applications; this guide focuses on using the Genstore CLI.

Create with Genstore CLI

Prerequisites

Before you begin, ensure you have:

  • An active Genstore partner account with a developer store
  • The latest version of Genstore CLI installed
  • Chrome or Firefox (latest version)

Create your app

Initialize your project

  1. Open your terminal and navigate to your development directory:
  2. Initialize your app:
bash
genstore app init

The CLI wizard will prompt you to:

  • Select a template for your app
  • Provide an app name
  • Configure basic settings

For details about the configuration items, see Configure app

Project structure

After initialization, your project contains:

bash
your-app-name/
├── app/                 # Core app codes
├── extensions/          # Extension modules
├── genstore.app.toml    # App configuration
└── package.json         # Dependencies

For details, see App structure

Development workflow

bash
cd your-app-name

Test with a development store

After your app runs successfully locally, you can start testing with a developer store.

bash
genstore app dev

The CLI generates a secure preview URL. Use this link to:

  • Installs your app in the development store
  • Opens the app interface
  • Enables testing in a sandbox environment

For details about this command, see app dev

Deploy your app

When your app is ready for production:

bash
genstore app deploy

This deployment process:

  • Creates a versioned snapshot of your app
  • Packages your configuration and extensions
  • Deploys to the Genstore platform

For details about this command, see app deploy