Quickstart

npm install -g salesive-dev-tools
# or
yarn global add salesive-dev-tools
# or
pnpm add -g salesive-dev-tools
# or
bun add -g salesive-dev-tools

salesive --version

# paste your sk-... key when prompted (input is hidden)
salesive auth set-token

# confirm the key is valid and see its permissions
salesive auth verify

salesive init

? Project name: my-store
? Build tool: Vite
? Framework: React
? Package manager: npm

cd my-store

# install dependencies
npm install

# start the dev server
npm run dev

import { useEffect, useState } from "react";
import { products } from "salesive-api-axios";
import { useSalesiveConfig } from "salesive-dev-tools";

function App() {
    const appName = useSalesiveConfig("app-name");
    const brandColor = useSalesiveConfig("color-brand-primary");
    const [items, setItems] = useState([]);

    useEffect(() => {
        // The catalog adapts to the store type — read `catalogType`/`itemType`
        // to support ecommerce, restaurant, and business stores.
        products.list({ limit: 10 }).then(({ data }) => {
            setItems(data?.data?.products ?? []);
        });
    }, []);

    return (
        <div style={{ color: brandColor }}>
            <h1>{appName}</h1>
            <p>{items.length} catalog items</p>
        </div>
    );
}

# optional: catch config errors before publishing
salesive validate

# build, package, and upload to the Themes API
salesive cook

# common options
salesive cook --no-build      # skip the automatic build
salesive cook --path ./theme  # publish from a specific directory
salesive cook --keep-temp     # keep the temp bundle for debugging
salesive cook --verbose       # detailed error output