Strumenti

Scegliere

Tre modi di lavorare

Scelga in base a dove le piace scrivere. Niente di quello che fa in uno resta legato a quello.

Terminale

La CLI

whizzy-theme esegue sulla sua macchina lo stesso validatore dell'installatore, quindi una passata pulita in locale è un invio pulito. Accede al suo account sviluppatore, non a un negozio.

npm i -g https://whizzycommerce.com/cli/whizzy-theme.tgz
whizzy-theme login
whizzy-theme init harbour
cd harbour
whizzy-theme dev --page=home

validate esce con 0 quando non si scarterebbe niente, con 2 quando il tema si installa ma qualcosa verrebbe scartato, e con 1 quando non si installa. WHIZZY_ORIGIN punta la CLI a un altro indirizzo della piattaforma, cosa che le serve solo se le chiediamo di provare contro l'ambiente di test.

Automazione

CI con un token

In CI non c'è un browser con cui accedere. Crei un token in Sviluppatori › Token e lo salvi come segreto chiamato WHIZZY_TOKEN. Quando quella variabile c'è, la CLI la usa al posto del login.

Questo flusso di GitHub Actions convalida e carica ogni commit su main nel suo spazio di lavoro, e invia una versione quando pubblica un tag che comincia per v. Alzi version in theme.json prima di creare il tag.

name: theme
on:
  push:
    branches: [main]
    tags: ["v*"]

jobs:
  ship:
    runs-on: ubuntu-latest
    env:
      WHIZZY_TOKEN: ${{ secrets.WHIZZY_TOKEN }}
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      - run: npm i -g https://whizzycommerce.com/cli/whizzy-theme.tgz
      - run: whizzy-theme validate .
      - run: whizzy-theme push .
      - run: whizzy-theme submit . -m "${{ github.ref_name }}: see CHANGELOG.md"
        if: startsWith(github.ref, 'refs/tags/v')

Claude

Claude tramite il connettore per sviluppatori

Il connettore dà al suo Claude gli strumenti per leggere, scrivere, controllare, vedere in anteprima e inviare i suoi temi. Claude gira sul suo piano. Il nostro server esegue solo le chiamate agli strumenti.

claude mcp add --transport http whizzy-developer https://app.whizzycommerce.com/mcp/dev

Una conversazione che finisce in un invio è fatta così.

1. Lei

   Aggiungi una sezione lookbook a harbour: una foto grande con tre schede prodotto accanto, impilate sul telefono.

2. Claude

   read_theme_file, write_theme_files

   Legge theme.json e una sezione esistente per prendere le convenzioni, scrive sections/lookbook.json, e la aggiunge a templates/home.json.

3. Claude

   validate_theme

   Il validatore scarta una proprietà CSS. Claude la sostituisce con una che il sanitizzatore tiene.

4. Claude

   preview_theme, screenshot_page

   Guarda l'anteprima della home sul negozio del tema a 390 e 1440 pixel, si accorge che le schede escono sul telefono, e sistema la griglia.

5. Lei

   Bene così. Fallo 1.3.0 e invialo.

6. Claude

   write_theme_files, submit_release

   Alza la versione, scrive il changelog da quello che è cambiato, e le chiede conferma prima di inviare.

7. Claude

   get_release_status

   Riferisce che ogni controllo è passato e che la versione aspetta la revisione.

Senza installare niente

L'editor del browser

Sviluppatori › Temi › il suo tema › Editor. Un albero dei file, un editor di codice che convalida mentre scrive, un'anteprima della bozza sul negozio del tema e un pulsante Invia.

L'editor ha un pannello assistente facoltativo. Resta spento finché non ci incolla la sua chiave API Anthropic. La chiave viene verificata con Anthropic, sigillata a riposo, tenuta solo su quello spazio di lavoro, e può toglierla quando vuole. Ogni richiesta che fa l'assistente viene fatturata da Anthropic a quella chiave.

Chiaramente

Chi paga l'IA

Lei, direttamente, e solo per quello che usa.

Perché non c'è un terminale ospitato. Un terminale nella nostra app vorrebbe dire far girare una macchina isolata per sviluppatore, e far girare il suo accesso a Claude sui nostri server. Claude Code sul web è già quel terminale: gira sul suo repository, lo mantiene Anthropic, e lo paga il suo piano. Ci aggiunga il connettore e ha tutto quello che le darebbe un terminale ospitato. Per il resto, veda Per cominciare.