GitHub - flaviokalleu/flang: Flang is a bilingual declarative programming language for building full-stack web applications from .fg files.

A linguagem declarativa que transforma ideias em aplicacoes full-stack.

O que e · Quick Start · Exemplo · 20 Idiomas · Temas · CLI · Seguranca

O que e o Flang?

Flang e uma linguagem de programacao declarativa escrita em Go que gera aplicacoes web full-stack a partir de arquivos .fg. Escreva o que voce quer — dados, telas, eventos, logica — e o Flang gera backend, frontend, banco de dados, API REST, autenticacao e muito mais.

sistema loja

tema moderno
cor primaria azul

dados
  produto
    nome: texto obrigatorio
    preco: dinheiro
    status: enum(ativo, inativo, pendente)

telas
  tela produtos
    titulo "Produtos"
    lista produto
      mostrar nome, preco, status
    botao azul
      texto "Novo Produto"

eventos
  quando clicar "Novo Produto"
    criar produto

flang run loja.fg
# App completa rodando em http://localhost:8080

Quick Start

Instalacao

# Build do fonte
git clone https://github.com/flaviokalleu/flang.git
cd flang
go build -o flang .

# Ou via instalador (Linux/macOS)
curl -fsSL https://github.com/flaviokalleu/flang/releases/latest/download/install.sh | sh

Criar e rodar

# Criar novo projeto
flang new meu-app

# Rodar
cd meu-app
flang run inicio.fg

# Abrir no navegador
# http://localhost:8080

Exemplo Completo

sistema restaurante

tema elegante
cor primaria vermelho
estilo glassmorphism

dados
  prato
    nome: texto obrigatorio
    descricao: texto_longo
    preco: dinheiro
    categoria: texto
    disponivel: booleano
    foto: imagem
    status: enum(disponivel, esgotado, em_preparo)

  pedido
    cliente: texto obrigatorio
    telefone: telefone
    prato: pertence_a prato
    quantidade: numero
    observacao: texto_longo
    status: enum(recebido, preparando, pronto, entregue)

telas
  tela cardapio
    titulo "Cardapio"
    lista prato
      mostrar nome, preco, status, foto
    botao vermelho
      texto "Novo Prato"

  tela pedidos
    titulo "Pedidos"
    lista pedido
      mostrar cliente, prato, quantidade, status

eventos
  quando clicar "Novo Prato"
    criar prato

  quando criar pedido
    notificar "Novo pedido recebido!"

logica
  funcao calcular_total(preco, quantidade)
    retornar preco * quantidade

autenticacao
  modelo: usuario
  campo_login: email
  campo_senha: senha
  roles: admin, garcom, cozinha

integracoes
  whatsapp
    quando criar pedido
      enviar mensagem para telefone
        texto "Pedido recebido! {prato} x{quantidade}"

  email
    servidor: "smtp.gmail.com"
    porta: "587"
    quando criar pedido
      enviar email para cliente.email
        assunto "Pedido confirmado"
        texto "Seu pedido foi confirmado!"

  cron
    cada 30 minutos
      executar verificar_estoque

Features

Linguagem e Runtime

Feature	Descricao
20 idiomas	Keywords em PT, EN, ES, FR, DE, IT, ZH, JA, KO, AR, HI, BN, RU, ID, TR, VI, PL, NL, TH, SW
Mistura livre	Use keywords de qualquer idioma no mesmo arquivo
Variaveis	`definir x = 10` / `set x = 10`
Funcoes	`funcao soma(a, b)` / `function sum(a, b)`
Condicionais	`se/senao/senao se` / `if/else/else if`
Loops	`repetir N vezes`, `enquanto`, `para cada`
Controle de fluxo	`parar`, `continuar`, `retornar`
Tratamento de erros	`tentar/erro` (try/catch)
Enums	`status: enum(ativo, inativo, pendente)`
30+ funcoes built-in	Texto, numero, async, e mais

Full-Stack Automatico

Feature	Descricao
Backend	Servidor HTTP embutido com API REST completa
Frontend	Dashboard moderno com dark mode e sidebar
Banco de dados	SQLite, MySQL, PostgreSQL
WebSocket	Tempo real entre multiplos usuarios
Upload	Arquivos com preview automatico
Paginacao	`?pagina=1&limite=10&busca=texto&ordenar=preco`
Export	CSV e JSON com um clique
Hot reload	Alteracoes refletidas automaticamente

Seguranca

Feature	Descricao
JWT Auth	Login, registro, tokens JWT com bcrypt
Roles	Controle de acesso por papel (admin, user, etc.)
Rate limiting	Protecao contra abuso de requisicoes
SSRF protection	Bloqueio de requisicoes a redes internas
XSS prevention	Sanitizacao automatica de inputs
SQL Injection	Queries parametrizadas
Security headers	X-Content-Type-Options, X-Frame-Options, CSP

Integracoes

Feature	Descricao
WhatsApp	Mensagens automaticas via whatsmeow
Email	SMTP com templates HTML
Cron	Agendamentos (`cada 5 minutos`, `cada 1 hora`)
HTTP Client	Chamar APIs externas
Webhooks	Receber notificacoes

20 Idiomas

Flang suporta keywords em 20 idiomas. Voce pode misturar idiomas livremente no mesmo arquivo.

Portugues

sistema loja

dados
  produto
    nome: texto obrigatorio
    preco: dinheiro

English

system store

models
  product
    name: text required
    price: money

Espanol

sistema tienda

datos
  producto
    nombre: texto obligatorio
    precio: dinero

Francais

systeme magasin

donnees
  produit
    nom: texte obligatoire
    prix: argent

Deutsch

system laden

daten
  produkt
    name: text erforderlich
    preis: geld

Italiano

sistema negozio

dati
  prodotto
    nome: testo obbligatorio
    prezzo: denaro

Idiomas suportados: Portugues, English, Espanol, Francais, Deutsch, Italiano, Zhongwen, Nihongo, Hangugeo, Alarabiya, Hindi, Bangla, Russkiy, Bahasa Indonesia, Turkce, Tieng Viet, Polski, Nederlands, Thai, Kiswahili.

Temas e Estilos

Presets de Tema

tema moderno       # Design moderno com sombras e gradientes
tema simples       # Clean e minimalista
tema elegante      # Sofisticado com tipografia refinada
tema corporativo   # Profissional para empresas
tema claro         # Leve e luminoso

Cores por Nome

Sem necessidade de codigos hex — use nomes de cores diretamente:

cor primaria azul
cor primaria vermelho
cor primaria verde
cor primaria roxo
cor primaria laranja

Estilos Visuais

estilo glassmorphism    # Transparencia e blur (padrao)
estilo flat             # Cores solidas sem sombras
estilo neumorphism      # Efeito 3D suave
estilo minimal          # Minimo de elementos visuais

Exemplo Combinado

sistema dashboard

tema corporativo
cor primaria azul
estilo glassmorphism

Tipos de Dados

Tipo PT	Tipo EN	Descricao	Input HTML
`texto`	`text`	Texto simples	text
`texto_longo`	`long_text`	Texto longo	textarea
`numero`	`number`	Numero	number
`dinheiro`	`money`	Valor monetario	number
`email`	`email`	Com validacao	email
`telefone`	`phone`	Com validacao	tel
`data`	`date`	Data	date
`booleano`	`boolean`	Sim/Nao	checkbox
`senha`	`password`	Mascarado + bcrypt	password
`imagem`	`image`	Upload de imagem	file
`arquivo`	`file`	Upload de arquivo	file
`link`	`link`	URL	url
`status`	`status`	Badge colorido	text
`enum(...)`	`enum(...)`	Valores pre-definidos	select

Modificadores

PT	EN	Efeito
`obrigatorio`	`required`	NOT NULL + validacao
`unico`	`unique`	UNIQUE constraint
`indice`	`index`	CREATE INDEX
`soft_delete`	`soft_delete`	Exclusao logica

Relacionamentos

dados
  categoria
    nome: texto obrigatorio

  produto
    nome: texto obrigatorio
    preco: dinheiro
    categoria: pertence_a categoria       # FK: produto pertence a uma categoria

  tag
    nome: texto obrigatorio
    produtos: muitos_para_muitos produto   # Tabela intermediaria automatica

  pedido
    cliente: texto
    itens: tem_muitos item_pedido          # Um pedido tem muitos itens

Tipo	Descricao
`pertence_a` / `belongs_to`	Foreign key (N:1)
`tem_muitos` / `has_many`	Relacao inversa (1:N)
`muitos_para_muitos` / `many_to_many`	Tabela intermediaria (N:N)

Rotas, Paginas e Sidebar Personalizadas

Rotas Personalizadas

rotas_personalizadas
  rota "/dashboard"
    metodo "GET"
    resposta "Pagina principal"

  rota "/relatorio"
    metodo "GET"
    resposta "Relatorio mensal"

Paginas Personalizadas

paginas_personalizadas
  pagina "sobre"
    titulo "Sobre Nos"
    conteudo "Texto da pagina sobre a empresa."

Sidebar Personalizada

sidebar_personalizada
  item "Dashboard" icone "home" link "/dashboard"
  item "Relatorios" icone "chart" link "/relatorio"
  item "Configuracoes" icone "settings" link "/config"

Funcoes Async

Flang inclui funcoes async para operacoes paralelas e assincronas:

logica
  # Executar funcoes em paralelo
  paralelo
    chamar buscar_dados()
    chamar processar_relatorio()
    chamar enviar_notificacoes()

  # Esperar resultado
  definir resultado = esperar chamar_async(buscar_dados)

  # Timeout
  timeout 5000
    chamar operacao_lenta()

  # Consultas em paralelo
  definir dados = consultar_paralelo
    buscar usuarios
    buscar pedidos
    buscar produtos

Lista de Funcoes Built-in (30+)

Texto: texto, maiusculo, minusculo, contem, dividir, juntar, tamanho

Numero: numero, arredondar, abs, min, max, inteiro, aleatorio

Utilitarios: tipo, agora, mostrar

Async: paralelo, esperar, timeout, chamar_async, consultar_paralelo

Seguranca

autenticacao
  modelo: usuario
  campo_login: email
  campo_senha: senha
  roles: admin, vendedor, cliente

Recurso	Implementacao
Autenticacao	JWT tokens com expiracao
Senhas	Hash bcrypt automatico
Roles	Controle de acesso baseado em papel
Rate Limiting	Limite de requisicoes por IP
SSRF	Bloqueio de acesso a redes internas
XSS	Sanitizacao de inputs e outputs
SQL Injection	Queries parametrizadas
Headers	CSP, X-Frame-Options, X-Content-Type-Options
Validacao	`obrigatorio`, `unico`, `email`, `telefone`

CLI

Comando	Descricao
`flang run arquivo.fg`	Executa o arquivo .fg
`flang arquivo.fg`	Atalho para run
`flang check arquivo.fg`	Verifica sintaxe sem executar
`flang new nome`	Cria novo projeto com estrutura basica
`flang init nome`	Cria projeto com .env e Docker
`flang build arquivo.fg`	Gera executavel standalone
`flang docker`	Gera Dockerfile e docker-compose
`flang version`	Mostra a versao atual
`flang help`	Mostra ajuda

API REST

Cada modelo gera automaticamente endpoints REST:

Metodo	Rota	Acao
`GET`	`/api/{modelo}`	Listar (com paginacao, filtros, busca)
`GET`	`/api/{modelo}/{id}`	Buscar por ID
`POST`	`/api/{modelo}`	Criar
`PUT`	`/api/{modelo}/{id}`	Atualizar
`DELETE`	`/api/{modelo}/{id}`	Deletar

Query Parameters

?pagina=1&limite=10          # Paginacao
?busca=texto                 # Busca full-text
?status=ativo                # Filtro por campo
?ordenar=preco&ordem=ASC     # Ordenacao

Endpoints Especiais

Rota	Descricao
`/api/login`	Login (JWT)
`/api/registro`	Registro
`/api/me`	Usuario atual
`/api/_stats`	Estatisticas
`/api/{modelo}/export/csv`	Exportar CSV
`/api/{modelo}/export/json`	Exportar JSON
`/upload`	Upload de arquivos
`/health`	Health check
`/ws`	WebSocket

Extensao VS Code

A extensao vscode-flang oferece:

Syntax highlighting para arquivos .fg
22 snippets para produtividade rapida
Reconhecimento de keywords nos 20 idiomas suportados

Instalacao

# Na pasta do projeto
cd vscode-flang
# Copie para extensoes do VS Code
cp -r . ~/.vscode/extensions/vscode-flang

Estrutura do Projeto

flang/
├── main.go                  # Ponto de entrada
├── cli/                     # Comandos CLI
├── compiler/
│   ├── lexer/               # Tokenizador (20 idiomas)
│   ├── parser/              # Parser -> AST
│   └── ast/                 # Nodes da AST
├── runtime/
│   ├── interpreter/         # Motor de scripting
│   ├── auth/                # JWT + bcrypt + roles
│   ├── banco/               # SQLite, MySQL, PostgreSQL
│   ├── servidor/            # HTTP + WebSocket + Renderer
│   ├── whatsapp/            # Integracao WhatsApp
│   ├── email/               # SMTP com templates HTML
│   ├── cron/                # Agendamentos
│   └── httpclient/          # HTTP client
├── vscode-flang/            # Extensao VS Code
├── examples/                # Programas de exemplo
├── demo/                    # Aplicacoes completas
├── docs/                    # Documentacao
└── installer/               # Instaladores Windows/Linux

Contribuir

git clone https://github.com/flaviokalleu/flang.git
cd flang
go build -o flang .
go test ./... -v

Fork o repositorio
Crie sua branch (git checkout -b feature/nova-feature)
Commit suas alteracoes (git commit -m 'Add: nova feature')
Push para a branch (git push origin feature/nova-feature)
Abra um Pull Request

Licenca

MIT License — veja LICENSE

Flang v0.5.0 — Descreva. Programe. Execute.
_{Feito por @flaviokalleu}

Name		Name	Last commit message	Last commit date
Latest commit History 56 Commits
.github		.github
cli		cli
compiler		compiler
demo		demo
dist		dist
docs		docs
examples		examples
installer		installer
runtime		runtime
scripts		scripts
vscode-flang		vscode-flang
.gitattributes		.gitattributes
.gitignore		.gitignore
.goreleaser.yml		.goreleaser.yml
CLAUDE.md		CLAUDE.md
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
docker-compose.yml		docker-compose.yml
flang.exe~		flang.exe~
go.mod		go.mod
go.sum		go.sum
logo.png		logo.png
main.go		main.go

Folders and files

Latest commit

History

Repository files navigation

O que e o Flang?

Quick Start

Instalacao

Criar e rodar

Exemplo Completo

Features

Linguagem e Runtime

Full-Stack Automatico

Seguranca

Integracoes

20 Idiomas

Portugues

English

Espanol

Francais

Deutsch

Italiano

Temas e Estilos

Presets de Tema

Cores por Nome

Estilos Visuais

Exemplo Combinado

Tipos de Dados

Modificadores

Relacionamentos

Rotas, Paginas e Sidebar Personalizadas

Rotas Personalizadas

Paginas Personalizadas

Sidebar Personalizada

Funcoes Async

Lista de Funcoes Built-in (30+)

Seguranca

CLI

API REST

Query Parameters

Endpoints Especiais

Extensao VS Code

Instalacao

Estrutura do Projeto

Contribuir

Licenca

About

Topics

Resources

License

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 4

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages