Como a Formly funciona
Você define uma tabela: uma lista dos campos que quer cadastrar (nome, data, valor, uma referência a outro cadastro…). Assim que salva, a Formly já gera sozinha o formulário de cadastro e a listagem dos registros — sem escrever código.
A partir dos mesmos dados, dá pra montar telas sob medida — um relatório, um calendário, um quadro kanban, um painel de gráficos e outras visões, listadas mais abaixo. Tabelas relacionadas podem ainda ser agrupadas num módulo, com acesso restrito a quem você escolher.
Esta página é o catálogo completo: os tipos de campo e de tela, o que dá pra configurar em cada Tabela e em cada Tela, como usar tudo isso pela API e como habilitar a geração por IA. Pra uma visão rápida (4 passos), veja a página inicial.
Tipos de campo
Cada campo da sua tabela é de um desses tipos. O exemplo mostra como o valor aparece pronto, na listagem.
Texto
Texto curto — um nome, um título, qualquer informação de uma linha.
Texto longo
Texto longo, com formatação (negrito, listas, links) — para descrições e observações.
Texto com máscara
Texto com um formato fixo, podendo misturar números e letras — como telefone, CPF ou placa de carro (ex.: ABC-1234).
Um endereço de e-mail, validado e clicável.
CPF/CNPJ
Um CPF ou CNPJ, validado e formatado sozinho.
Número
Números — quantidade, idade, medidas.
Cálculo (calculadora)
Um valor numérico digitado com a ajuda de uma calculadora embutida.
Intervalado por número
Um número escolhido dentro de uma faixa, em passos definidos (ex.: de 5 em 5).
Avaliação (estrelas)
Uma nota em estrelas.
Moeda (R$)
Um valor em dinheiro (R$), formatado automaticamente.
Percentual (%)
Um número de 0 a 100, com o símbolo %.
Progresso (barra)
Um percentual mostrado como barrinha de progresso.
Data
Uma data — dia, mês e ano.
Data e hora
Data e horário juntos.
Mês/Ano
Um mês e ano, sem dia — útil pra competências e faturas.
Hora
Um horário (hora e minuto).
Intervalado por tempo
Um horário escolhido entre opções já prontas, em intervalos regulares (ex.: a cada 30 minutos).
Período (data início / fim)
Um período — data de início e data de fim.
Duração (horas/minutos)
Uma duração em horas e minutos — soma bonito em relatórios.
Lista de opções
Uma lista de opções fixas — a pessoa escolhe uma.
Múltipla escolha
Uma lista de opções onde dá pra marcar várias ao mesmo tempo.
Sim/Não
Sim ou não — um interruptor simples pra marcar algo como ativo ou verdadeiro.
Tags (texto livre)
Palavras-chave livres, digitadas uma a uma.
Árvore (hierarquia)
Uma opção escolhida dentro de uma hierarquia, como categorias e subcategorias.
Referência a outro schema
Liga este registro a outro cadastro — por exemplo, o cliente de um pedido.
Texto montado por referência
Texto longo montado escolhendo pedaços de outro cadastro relacionado.
Calculado (fórmula)
Calculado sozinho a partir de outros campos, com uma fórmula — nunca é digitado.
Rótulo (concatenação de campos)
Um texto automático que junta o valor de outros campos — só pra exibição, ninguém digita.
Condicional (por regra)
Um texto que muda sozinho, de acordo com regras que comparam outros campos.
Contador de relacionados
Uma contagem automática de quantos registros relacionados existem.
FieldTypeLabels.lista_relacionada
Uma lista dos registros relacionados, com botões para cadastrar novos itens ou remover existentes.
Contagem regressiva (countdown)
Uma contagem regressiva ao vivo até uma data e hora.
Anexo (upload de arquivo)
Upload de um arquivo qualquer (imagem, documento ou compactado).
Imagem
Upload de uma imagem, com miniatura.
Marcação em imagem (desenhar)
Uma imagem onde dá pra desenhar por cima — por exemplo, marcar onde dói num corpo humano.
Assinatura
Uma assinatura desenhada na tela, com o dedo ou o mouse.
Cor (paleta RGB)
Uma cor, escolhida numa paleta.
Ícone
Um ícone escolhido numa galeria.
Link (externo/interno)
Um link clicável — fixo (definido no schema) ou digitado por quem preenche.
CEP (busca de endereço)
Um CEP — ao digitar, busca o endereço sozinho.
Sequencial (numeração automática)
Um número gerado automaticamente pelo sistema, em ordem — como um número de pedido.
Usuário (autoria automática)
Registra sozinho quem criou (ou alterou) o registro — ninguém preenche isso na mão.
Código de barras
Gera um código de barras a partir de um texto ou número.
QR Code
Gera um QR Code a partir de um texto ou número.
Lista de verificação (checklist)
Uma lista de itens marcáveis, como uma lista de tarefas.
Opções da Tabela
Além de escolher os campos, uma tabela tem estas possibilidades — todas opcionais, ative só o que fizer sentido.
Rótulo principal
Escolha qual campo identifica o registro quando ele é citado em outro cadastro — por exemplo, o nome do cliente, em vez de um código.
Seções e abas condicionais
Agrupe os campos visualmente, inclusive em abas. Uma seção pode ficar escondida até outro campo ter um valor específico — sem telas cheias de perguntas que não se aplicam.
Registro ativo/inativo
Em vez de excluir de vez, marque um campo Sim/Não como o "interruptor" do registro — ele some da listagem por padrão, mas continua guardado.
Ordenação padrão
Escolha por qual campo — e em que direção — a listagem já abre ordenada.
Fluxo de aprovação
Vincule um campo de status a uma esteira de aceite: o registro fica "aguardando" até alguém aprovar ou rejeitar, com histórico das decisões.
Efeito em estoque
Quando um campo referencia outro cadastro, ele pode dar baixa ou entrada automática num número desse cadastro relacionado — como uma venda descontando o estoque do produto.
Histórico por campo
Qualquer campo pode guardar um histórico de alterações — data, valor antigo e valor novo — toda vez que é editado.
Módulos
Agrupe várias tabelas relacionadas sob um mesmo endereço e controle quem tem acesso, por usuário.
Importar e exportar
Leve a estrutura de uma tabela (campos, seções, configurações) de um ambiente para outro, num arquivo só.
Tipos de tela
Uma tela é uma visão salva sobre os dados de uma tabela. Você pode criar quantas quiser, de qualquer um destes tipos.
Relatório
Uma tabela filtrada, com as colunas que você escolher e um rodapé de totais opcional. Ótima pra listar e conferir dados rapidamente.
Calendário
Mostra os registros como eventos num calendário, a partir de um campo de data. Dá pra escolher a visão inicial (mês, semana, lista…).
Formulário
Uma grade de dados editável — cada linha tem seu próprio botão Salvar, ótima pra ajustes rápidos em vários registros de uma vez.
Formulário associado
Mostra um registro principal e, logo abaixo, tudo que está relacionado a ele — como um cliente e o histórico de pedidos dele.
Documento (cabeçalho + itens)
Um cabeçalho (ex.: um pedido) e uma grade de itens embaixo, tudo numa tela só, com um único botão Salvar e o total somado no rodapé.
Kanban
Um quadro com colunas — arraste um cartão de uma coluna pra outra e o status dele muda sozinho.
Chamador (painel de chamadas)
Um painel de chamadas: quem atende escolhe um registro e chama; um telão mostra a chamada atual em destaque — ótimo pra recepções e filas.
Painel de gráficos
Vários gráficos (barras, linhas, pizza, indicadores) lado a lado, cada um olhando pra uma tabela e uma métrica diferente.
Links de referência
Uma tela de atalhos — botões grandes que abrem um formulário de cadastro ou um conteúdo externo (como um vídeo) num modal.
Jornada (cadastro guiado)
Um cadastro guiado, passo a passo — cada passo cria um registro já ligado ao passo anterior, na ordem certa.
Opções da Tela
Independente do tipo escolhido, estas possibilidades valem pra a maioria das telas.
Tabela de origem
Toda tela (menos "Links" e "Jornada") é uma visão sobre os dados de uma tabela — dá pra criar quantas telas quiser sobre a mesma tabela.
Filtros
Fixe um filtro (sempre aplicado) ou deixe editável, pra quem está vendo a tela escolher o valor. As opções (contém, igual a, entre, vazio…) mudam de acordo com o tipo do campo.
Resumo e totais
Some, conte, tire a média, o mínimo ou o máximo de um campo numérico, mostrado no rodapé da tela.
Cor da linha ou do evento
Destaque visualmente cada linha (ou evento do calendário) usando um campo de cor da tabela, ou de um cadastro relacionado.
Colunas escolhidas
No relatório, escolha quais campos aparecem como coluna, e em que ordem.
Link público de cadastro
Gere uma URL sem login pra qualquer tela — só o formulário, sem menu nenhum (no Formulário associado, é um fluxo de dois passos: escolher ou cadastrar o principal e, depois, o associado já vinculado a ele). Dá pra desativar ou trocar o link quando quiser.
Fixar no menu lateral
Qualquer tela pode ser fixada na barra lateral do app, pra acesso rápido de quem usa todo dia.
Use pela API
Toda tabela já nasce com uma API pronta — sem escrever nada.
CRUD pronto por tabela
Cada tabela vira automaticamente uma rota que cria, lista, altera e exclui registros — nada pra configurar.
Documentação interativa
Uma página de documentação (Swagger/OpenAPI) é gerada sozinha a partir das suas tabelas, sempre atualizada.
Duas formas de autenticar
Sessão (cookie), pra quem usa pelo navegador, ou uma chave de API, pensada pra sistemas externos.
Mesmas permissões de sempre
Uma chave de API pertence a um usuário e herda o perfil dele — as mesmas regras de leitura e escrita do app valem pra ela.
A chave é gerada por um admin na tela Usuários, e enviada em Authorization: Bearer <chave> ou X-API-Key.
Como habilitar
A Formly gera tabelas, telas e dados de exemplo a partir de um pedido em texto — usando a sua própria chave de IA.
1. Gere uma chave
Acesse o painel de um provedor — OpenAI, Anthropic ou Google Gemini — e crie uma chave de API. É grátis pra gerar; o custo é só pelo uso.
2. Cadastre na Formly
Já logado, um admin cola a chave em Configuração → Chaves de IA. Ela fica cifrada no servidor; só os últimos dígitos aparecem depois.
3. Use o ícone de robô
Na barra do app, descreva o que quer num campo de texto. A IA sugere uma tabela, uma tela e/ou dados de exemplo, mostrando quantos tokens foram usados e o que vai ser criado — antes de confirmar.
Exemplos de prompt
Não sabe por onde começar? Alguns pedidos que funcionam bem — dá pra pedir só uma dessas coisas de cada vez, ou o sistema inteiro numa tacada só.
“Crie uma tabela de Fornecedores com nome, CNPJ, telefone, e-mail e categoria (matéria-prima, serviços ou equipamentos).”
“Crie uma tela de relatório pra tabela Produtos, com as colunas nome, categoria e estoque, e um resumo somando o estoque total.”
“Gere 5 registros de exemplo pra tabela Fornecedores.”
“Crie uma tabela de Manutenções vinculada à tabela Veículos, com tipo de serviço, data e custo.”
“Crie um sistema de controle de biblioteca: livros (título, autor, categoria, exemplares disponíveis), membros (nome, e-mail, telefone) e empréstimos (livro, membro, data de retirada, data prevista de devolução, status).”
O custo das chamadas é cobrado na sua própria conta do provedor escolhido — a Formly nunca intermedia esse valor.
O conteúdo gerado sai no idioma da sua interface (troque em Português/English no topo da página), com as convenções regionais correspondentes — o mesmo pedido volta em português ou em inglês dependendo do idioma escolhido, mesmo que você escreva o pedido em outro idioma.
Monte sua solução hoje
Entre e crie a primeira tabela — os formulários, as listagens e as telas vêm juntos.