Getting Started with Apps

This guide will walk you through the initial steps of creating and developing your first SitePack App.

Prerequisites

Before you begin, ensure you have:

• A free partner account on SitePack.
• The SitePack CLI installed and authenticated.

1. Creating Your App

There are two primary ways to initiate a new SitePack App:

Option A: From the Partner Dashboard (Recommended)

1. Log in to the SitePack Partner Dashboard.
2. Navigate to the Apps section and click Create New App.
3. Fill in the basic details for your app.
4. Once created, use the SitePack CLI to download the app files to your local machine:

   sitepack app:checkout

   Follow the prompts to select your app.

Option B: From the CLI

If you prefer to start locally, you can use the CLI:

1. Run the following command:

   sitepack app:init

2. Follow the prompts to name your app and configure its initial settings. This will create the necessary file structure locally.

2. Developing Your App

Once your app is initialized, you can start building its functionality. The core of your app is the app.json manifest file, which defines your app's permissions, webhooks, and UI extensions.

Next Steps

Now that you've initialized your app, dive deeper into the technical details:

• App Manifest (app.json): Define your app's structure and permissions.
• Authentication (OAuth): Securely interact with SitePack stores.
• Scopes & Permissions: Request the right data access.
• Webhooks: Respond to real-time events.
• Editor Elements: Build custom blocks for the visual editor.
• Admin UI Integration: Add settings and widgets to the Admin dashboard.
• Publishing & Monetization: Share and sell your app.

3. Publishing Your App

When you are ready to share your app or test it in a live environment, use the CLI to publish it:

sitepack app:publish

This command synchronizes your local files with the SitePack servers and creates a new version of your app.

Visibility and Monetization

An app can have different visibility settings:

• Private Apps: These are restricted to specific stores or your own organization. They are ideal for custom integrations.
• Public Apps: These are available on the SitePack Marketplace for all merchants to discover and install.

tip

An app is only sellable when it is set to Public. Refer to the Publishing & Monetization section for more details on pricing models.