# 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](/pt-BR/docs/recursos/troubleshooting) e [Os dois caminhos](/pt-BR/docs/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](/pt-BR/docs/recursos/changelog) antes de subir de versão, e fixe versões em produção. A política completa está em [Versionamento](/pt-BR/docs/referencia/versoes).

## 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](/pt-BR/docs/plugins-proprios/incubator).

## 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](/pt-BR/docs/recursos/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](/pt-BR/docs/tutorial/05-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](/pt-BR/docs/deploy/estatico).