07 · Publicar

Gere o build de produção. Ele é o seu teste de compilação: se o Vite empacota o app sem erro, o código está íntegro para publicar.

npm run build

Saída real:

vite v5.4.21 building for production...
✓ 34 modules transformed.
dist/index.html                   0.40 kB │ gzip:  0.27 kB
dist/assets/index-tn0RQdqM.css    0.00 kB │ gzip:  0.02 kB
dist/assets/index-BERJrSU-.js   143.00 kB │ gzip: 46.00 kB
✓ built in 274ms

O resultado é uma pasta dist/ pronta para servir. Em seguida, rode o doctor para validar o manifesto uma última vez:

fayz doctor

⚠ plugins referenced by manifest are resolved by the platform bundle, not public npm packages: dashboard

0 error(s), 1 warning(s)

Seu app é o seu repositório. Antes de commitar, adicione a pasta .fayz/ ao .gitignore — ela guarda o vínculo local do deploy (.fayz/project.json) e não deve ir para o repositório. O scaffold ainda não cobre isso, então faça manualmente:

# na raiz do app, garanta que .fayz/ está ignorado
echo ".fayz/" >> .gitignore

Agora inicialize o repositório e faça o primeiro commit:

git init
git add .
git commit -m "feat: meu app Fayz"

Crie o repositório remoto — pela CLI do GitHub ou pelo site — e faça o push:

# com a gh CLI
gh repo create minha-loja --private --source=. --push

# ou, se você criou o repo pelo site:
git remote add origin https://github.com/<voce>/minha-loja.git
git push -u origin main

O deploy precisa de um token de acesso. Gere um em Fayz → Configurações → Tokens de acesso — ele vem com o prefixo fayz_. (O acesso de deploy está em rollout para a rede de desenvolvedores convidados.)

fayz login

Cole o token quando pedido. Saída real:

✓ Token salvo em ~/.fayz/credentials.json (permissão 0600).
  fayz_xxx…xxx
  O token será validado no primeiro deploy (nenhuma chamada de rede foi feita agora).

O login é local: ele só grava o token com permissão 0600 e o valida mais tarde, no primeiro deploy. Comandos úteis:

fayz login --status   # mostra o token mascarado, se já houver um
fayz logout           # remove o credentials.json

Em CI ou máquinas efêmeras, use a variável de ambiente FAYZ_TOKEN em vez do fayz login — a CLI a lê direto.

Antes de subir de verdade, rode o dry-run. Ele lista exatamente o que seria enviado e qual seria o destino, sem nenhuma chamada de rede:

fayz deploy --dry-run

Saída real:

▸ Arquivos a enviar de minha-loja:
  app.manifest.json  (1087 B)
  index.html  (299 B)
  …
  Total: 13 arquivo(s), 7099 B.
  Destino: novo projeto 'minha-loja' (será criado no primeiro deploy)
  (dry-run — nenhuma chamada de rede foi feita)

O nome do projeto é derivado do campo name do seu package.json. Confira a lista e o destino antes de prosseguir.

Agora suba de verdade:

fayz deploy

A CLI confirma o destino antes de agir (use --yes para pular a confirmação; em shell não interativo ela recusa rápido em vez de agir sozinha). No primeiro deploy ela cria o projeto na plataforma e grava .fayz/project.json com { projectId, name }; nos deploys seguintes ela reusa esse arquivo, mandando para o mesmo projeto. O código sobe em lotes, a plataforma builda no servidor (install + Vite) e devolve a URL final:

🔗 https://minha-loja.live.fayz.ai