Ferramentas

Escolher

Três formas de trabalhar

Escolha pelo sítio onde gosta de escrever. Nada do que fizer num fica preso a ele.

Terminal

A CLI

O whizzy-theme corre na sua máquina o mesmo validador do instalador, por isso uma passagem limpa localmente é uma submissão limpa. Entra na sua conta de programador, não numa loja.

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

O validate sai com 0 quando nada seria deitado fora, 2 quando o tema instala mas algo seria deitado fora, e 1 quando não instala. O WHIZZY_ORIGIN aponta a CLI para outro endereço da plataforma, o que só precisa se lhe pedirmos que teste contra o ambiente de testes.

Automatização

CI com um token

Em CI não há navegador para iniciar sessão. Crie um token em Programador › Tokens e guarde-o como um segredo chamado WHIZZY_TOKEN. Quando essa variável existe, a CLI usa-a em vez do login.

Este fluxo do GitHub Actions valida e envia todos os commits no main para o seu espaço de trabalho, e submete uma versão quando publica uma tag que começa por v. Suba o version no theme.json antes de criar a 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 pelo conector de programador

O conector dá ao seu próprio Claude as ferramentas para ler, escrever, verificar, pré-visualizar e submeter os seus temas. O Claude corre no seu plano. O nosso servidor só executa as chamadas de ferramenta.

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

Uma conversa que acaba numa submissão é assim.

1. Você

   Acrescenta uma secção de lookbook ao harbour: uma fotografia grande com três cartões de produto ao lado, empilhados no telemóvel.

2. Claude

   read_theme_file, write_theme_files

   Lê o theme.json e uma secção existente para apanhar as convenções, escreve sections/lookbook.json, e acrescenta-a a templates/home.json.

3. Claude

   validate_theme

   O validador deita fora uma propriedade CSS. O Claude substitui-a por uma que o sanitizador mantém.

4. Claude

   preview_theme, screenshot_page

   Pré-visualiza a página inicial na loja do próprio tema a 390 e 1440 píxeis, repara que os cartões transbordam no telemóvel, e corrige a grelha.

5. Você

   Está bom. Põe 1.3.0 e submete.

6. Claude

   write_theme_files, submit_release

   Sobe a versão, escreve o registo de alterações a partir do que mudou, e pede-lhe confirmação antes de submeter.

7. Claude

   get_release_status

   Reporta que todas as verificações passaram e que a versão está à espera de revisão.

Sem instalar nada

O editor no navegador

Programador › Temas › o seu tema › Editor. Uma árvore de ficheiros, um editor de código que valida enquanto escreve, uma pré-visualização do rascunho na loja do próprio tema e um botão de Submeter.

O editor tem um painel de assistente opcional. Fica desligado até lá colar a sua própria chave da API Anthropic. A chave é verificada com a Anthropic, selada em repouso, guardada só nesse espaço de trabalho, e pode retirá-la a qualquer momento. Todos os pedidos que o assistente faz são faturados pela Anthropic a essa chave.

Claramente

Quem paga a IA

Você, diretamente, e só o que usar.

Porque não há um terminal alojado. Um terminal na nossa aplicação significaria correr uma máquina isolada por programador, e correr o seu início de sessão do Claude nos nossos servidores. O Claude Code na web já é esse terminal: corre contra o seu repositório, a Anthropic mantém-no, e o seu plano paga-o. Acrescente aí o conector e tem tudo o que um terminal alojado lhe daria. Para o resto, veja Começar.