Imported from willcutrim/flet-app (
.agents/skills/flet-form-pattern/SKILL.md). Install upstream withnpx skills add willcutrim/flet-app --skill flet-form-pattern. Copyright stays with the author.
Flet Form Pattern
Use esta skill para formularios de cadastro, edicao e configuracao.
Fluxo
- Ler
AGENTS.md. - Procurar formulario parecido em
src/screens/products/form_screen.py,src/screens/customers/form_screen.pyousrc/screens/users/form_screen.py. - Reutilizar fields em
src/components/fields/e botoes emsrc/components/buttons/. - Delegar persistencia para state ou service apropriado.
Estrutura Recomendada
PageHeaderno topo, com titulo claro e subtitulo curto.SectionCardpara agrupar os campos.- Campos organizados em
ft.Rowcom containers expansivos quando houver pares de campos. - Campos longos em linha propria.
- Texto de status ou toast para feedback.
- Acoes no final com Cancelar e Salvar.
Regras De Campos
- Usar componentes existentes como
TextField,MoneyField,QuantityField,SelectFieldou wrappers locais antes de criar novos. - Usar constantes de
core.themepara borda, cor, radius e foco. - Validar obrigatorios antes de salvar.
- Validar formato basico de numero, dinheiro, quantidade ou selecao quando aplicavel.
- Exibir mensagens simples e acionaveis.
Regras De Acoes
- Botao principal salva.
- Botao secundario cancela e navega de volta.
- Usar
PrimaryButtonpara acao principal quando aplicavel. - Usar
core.routes.navigatepara voltar a lista ou detalhe.
Limites
- Nao chamar API diretamente no formulario.
- Nao salvar dados em componente visual.
- Nao duplicar mascara ou parse se ja existir helper no arquivo ou camada adequada.
- Nao criar abstracao generica de formulario sem repeticao real.
