FAQ

As perguntas que aparecem com mais frequência de quem está começando com a Fayz SDK.

É grátis? Qual a licença?

Os pacotes públicos da SDK são distribuídos sob licença MIT — livres para usar, inclusive comercialmente. A plataforma Fayz hospedada é um produto à parte; a SDK em si você pode instalar e rodar sem custo.

Posso usar a SDK sem a plataforma Fayz?

Em parte, e vale ser honesto sobre o limite. Você pode instalar o @fayz-ai/cli, gerar apps, editar o manifesto, ligar plugins e planejar migrations — tudo isso é público. Mas o app-runtime que renderiza o shell de admin a partir do manifesto é distribuído junto com a plataforma, então localmente pela SDK pública você ainda vê uma tela placeholder em vez do app montado. Veja Troubleshooting e Os dois caminhos para entender exatamente onde fica essa fronteira hoje.

Como funciona o versionamento antes da 1.0?

Cada pacote versiona por conta própria em 0.x. Enquanto estamos pré-1.0, uma release menor pode trazer mudança de comportamento — não trate 0.x como estritamente semver. Leia as notas do Changelog antes de subir de versão, e fixe versões em produção. A política completa está em Versionamento.

Posso criar meu próprio plugin?

Sim. O caminho recomendado é o incubator: um plugin que mora no src/plugins/ do seu app, seguindo o mesmo contrato dos plugins do catálogo, com dono do próprio banco e injetando UI nas superfícies da SDK. Ele pode amadurecer localmente e, se fizer sentido, graduar para o marketplace. Veja Plugins próprios.

Como contribuo com o core?

Por enquanto o desenvolvimento do core é conduzido pela Faya Labs. Se você quer propor uma mudança, corrigir algo ou construir junto, fale com a gente pela Comunidade — descreva o caso e a gente encaminha. Não há um fluxo público de pull request aberto hoje.

Qual a relação entre Fayz e Faya Labs?

Fayz é o produto — a SDK, os plugins, a plataforma. Faya Labs é quem constrói e mantém o Fayz, e a comunidade em volta dele. Quando você lê "a Faya Labs decidiu X", é sobre a direção do produto Fayz.

Preciso de Supabase para começar?

Não. Todo app gerado nasce com backend.provider: "mock", que roda com dados de exemplo e zero configuração — é o modo mock-first. Você só conecta um Supabase real quando quiser dados persistentes; aí preenche o .env.local e roda fayz db apply. Comece no mock, migre quando precisar. O passo a passo está em Dados reais com Supabase.

O que dá para publicar como site estático?

O front-end gerado é uma app Vite, então o build é um bundle estático publicável em qualquer host de arquivos. O que exige backend (dados reais via Supabase, tooling de migração) continua precisando das credenciais correspondentes. Veja Deploy estático.