HyperFrame
Análise e dimensionamento estrutural de edifícios de concreto armado — normas ABNT.
macOS + Windows (Tauri) e navegador. Alternativa moderna e aberta aos softwares
estruturais tradicionais do mercado — 100% open source, com binários por
sistema e código-fonte no site.
O que já faz (v0.2.52)
- Modelagem 2D em planta (estilo planta de forma): eixos com bulbos, pilares
(retangulares, circulares e em L, rotação 0/90/180/270°, nascendo/morrendo em
qualquer nível — transferência em viga), vigas em polilinha com snap/orto (seção
variável por trecho e furos na alma), lajes com detecção automática de contorno
fechado, cargas de alvenaria (inteiras ou por trecho), regiões de
escada/reservatório, furos/aberturas de laje (shaft, elevador — escadas abrem furo
automático, com X de vazio na planta), GEOMETRIA CURVA (curvar trecho de viga ou borda de laje por flecha — balcões e sacadas curvas viram polilinha em arco e TODO o pipeline funciona: pórtico com torção, grelha, quinhões, 3D, pranchas), underlay de DXF de arquitetura, múltiplas
plantas de forma (térreo ≠ tipo ≠ cobertura) — com undo/redo, atalhos e verificação
de consistência (avisos graves/médios/leves antes da análise)
- 3D sincronizado: seleção cruzada 2D↔3D, isolamento de pavimento, sombras, deformada
(interpolação de Hermite), diagramas N/My/Mz em fita sobre as barras, escadas e
reservatórios como sólidos (lance com degraus, laje inclinada e patamar; caixa com
paredes e tampa), lajes com furos reais sobre as escadas/aberturas e furos na
alma das vigas recortados no sólido (§13.2.5)
- Análise: pórtico espacial (6 GDL/nó) gerado automaticamente, diafragma rígido
mestre-escravo por pavimento, solver skyline LDLᵀ próprio, dois passes de rigidez
(ELU com 0,4/0,8·Eci·Ic — NBR 6118 §15.7.3 — e ELS integral), ANÁLISE MODAL
(períodos e formas por flexibilidade condensada nos mestres + Jacobi, massa efetiva
por direção) e SISMO NBR 15421 COMPLETO no dimensionamento (zonas/Ca/Cv/espectro,
forças equivalentes com T modal limitado a Cup·Ta como CASOS EQ± reais no pórtico,
torção acidental de 5% §9.4, combinações excepcionais NBR 8681 §4.3.3
(1,2G + E + ψ2·Q) na envoltória — vigas/pilares/fundações dimensionam PELO sismo —,
drifts δx = Cd·δxe/I por categoria, θ de estabilidade §9.6 e MÉTODO ESPECTRAL §10 — SRSS dos modos com ≥90% de massa e regra do cortante mínimo 0,85·H)
- Cargas e combinações: peso próprio, NBR 6120 (presets), quinhões de laje a 45°
ou pelas reações da grelha (método selecionável), vento NBR 6123 (S1/S2/S3, Ca pela Fig. 4 DIGITALIZADA — grade 10×8 log-bilinear, 0,7–2,2, editável), desaprumo global
(§11.3.3.4.1, combinado ao vento pela regra da norma), excentricidade do vento de 7,5% da face (torção no diafragma, NBR 6123 §6.6), 13 combinações ELU + 6 ELS
(NBR 8681), rigidez das vigas com mesa colaborante (§14.6.2.2 — inércia T no pórtico) e redistribuição opcional de M⁻ das vigas (§14.6.4.3, δ 0,75–1 com verificação de x/d)
- Estabilidade e serviço: γz e parâmetro α (§15.5), 2ª ordem global aproximada
0,95·γz (§15.7.2) E P-Δ ITERATIVO REAL (forças laterais fictícias por pavimento re-resolvidas até convergir, K fatorizada uma vez — o fator adotado é o MAIOR dos dois, e o P-Δ vale inclusive além do limite γz = 1,30), deslocamentos laterais (tab. 13.3), flechas de vigas e lajes
(Branson + fluência, L/250), fissuração ELS-W (wk vs tab. 13.4) e VIBRAÇÃO DE PISO §23.3 (f₁ = 18/√δ imediata QP ≥ 1,2·fcrit por uso — academia 8 Hz, dança 7, escritório 4, demais 3,5 — coluna própria na aba Lajes)
- Dimensionamento NBR 6118: vigas (flexão com MESA COLABORANTE §14.6.2.2 — seção T automática nos positivos quando há laje colada ao vão, bf = bw + mín(0,5·b2; 0,10·a) por lado com a por continuidade, LN na mesa ou decomposição mesa+alma — economia real de armadura + cisalhamento + torção §17.5 +
armadura de pele + barras; VIGA-PAREDE §22.4 detectada sozinha — l/h < 2/3 troca a flexão por tirante CEB com z próprio, malha de alma e biela do apoio), consolos §22.5 como ELEMENTO do pilar (nível/face/geometria/Fd no inspetor, verificação ao vivo, sólido no 3D, CARGA no pórtico — G = Fd/1,4 + momento da excentricidade — e desenho na elevação do pilar; biela-tirante z = 0,8d ou atrito-cisalhamento μ = 1,4, Hd ≥ 0,2·Fd, costura), pilares a flexo-compressão oblíqua (integração da
seção + pilar-padrão), PILAR-PAREDE/núcleo rígido §15.9 (maior dimensão > 5× a
espessura ⇒ decomposição automática em lâminas de 3·h com N repartido pela flexão do
eixo forte, 2ª ordem local na espessura, borda tracionada vira tirante e mínimos
§18.5 — malha vertical/horizontal por face), lajes maciças (Marcus ou GRELHA DE PAVIMENTO UNIFICADA — todas as lajes da planta numa malha só com CONTINUIDADE entre vizinhas, vigas como barras flexíveis com EI real e torção fissurada 0,15·GJ, apoios nos pilares; contorno
qualquer, furos e lajes lisas com pilar interno), lajes nervuradas (§13.2.4.2 —
peso real com enchimento, seção T por nervura, cisalhamento §19.4.1), punção §19.5
(pilares internos, de borda e de canto com transferência de momento K·MSd,
perímetros reduzidos u*, reação real da grelha, desconto por aberturas §19.5.1 e ARMADURA DE PUNÇÃO dimensionada — linhas de conectores até o contorno C″ §19.5.3.4 e colapso progressivo §19.5.4),
escadas RETAS, EM L e EM U (lance como laje inclinada; L/U: lance + patamar contínuos com Mmax exato onde V = 0, nota da armadura da dobra contra empuxo ao vazio, dois lances no 3D) e
reservatórios (paredes/fundo/tampa com estanqueidade wk ≤ 0,2 mm)
- Fundações: sapatas rígidas (bielas/CG com presets de solo), sapatas
ASSOCIADAS (2 pilares numa sapata: CG na resultante, viga invertida com armadura
superior entre pilares + balanços/transversal), blocos sobre
estacas (Blévot 1–5; 6–16 pelo método CEB-70 — malha retangular, flexão na
seção S1 e cortante na S2, bloco rígido §22.7.1) ou tubulões a céu
aberto (fuste + base alargada, NBR 6122), editáveis por pilar (tipo, a×b ou nº
de estacas fixados ⇒ o programa VERIFICA em vez de dimensionar; offset de divisa vira
momento N·e; COTA DE ASSENTAMENTO ESTRUTURAL — sapatas em cotas diferentes p/
terreno em aclive/declive: o apoio desce no modelo com tramo de arranque no
pórtico e a verificação NBR 6122 §7.7 confere o afastamento entre bordos de
sapatas vizinhas — reta com α ≥ 60°/45°/30° da vertical conforme o solo, com
aviso e ordem executiva), sapata de divisa com VIGA ALAVANCA (R1
amplificada, sapata centrada, alívio no pilar interno, viga dimensionada à flexão e
cisalhamento com armadura superior + estribos), desenhadas no 2D e no 3D, planta
de fundações (locação, contornos, estacas, eixo das alavancas e resumo),
detalhamento de fundações (armaduras da sapata/bloco + quadro das VAs) e planta
de cargas (reações
características por pilar), MURO DE ARRIMO (empuxo de Rankine, tombamento/deslizamento FS ≥ 1,5, tensões na base, fuste e talão dimensionados com notas de drenagem), RADIER rígido (pressão linear pela resultante, punção §19.5 por pilar, flexão por faixas com malha dupla), baldrames sobre apoio elástico de Winkler (ks manual,
da sondagem ou 120·σadm; pressão no solo × σadm)
- ALVENARIA ESTRUTURAL (NBR 16868-1:2020) — Fase 1: parede estrutural como
ELEMENTO (ferramenta própria no editor, bloco de concreto/cerâmico 14/19, fpk de
prisma), acúmulo vertical de cargas por pavimento (peso próprio + quinhão das lajes),
compressão simples com NRd = fd·t·[1 − (λ/40)³] (fk = 0,7/0,6·fpk, γm = 2,0, λ ≤ 24),
aba própria de resultados com fpk mínimo de prisma POR PAVIMENTO (a especificação
que vai p/ a obra), paredes no 3D; Fase 2: ABERTURAS (portas/janelas criando grupos isolados com concentração de carga pelas vergas) e CONTRAVENTAMENTO AO VENTO (distribuição por rigidez I = t·L³, cisalhamento fvk = 0,15+0,5·σ ≤ 1,4 MPa, flexocompressão com tração de borda ⇒ graute + armadura calculada); Fase 3: MODULAÇÃO M-20 com amarração defasada (fiadas A/B), ELEVAÇÃO DE PAREDE em prancha (fiadas desenhadas, vergas em canaleta com apoio de 30 cm, cinta de respaldo, cotas) e QUADRO DE BLOCOS por pavimento (inteiros/meios/canaletas) — SVG/DXF/PDF; Fase 4 — INTEGRAÇÃO: lajes reconhecem paredes como apoio, TRANSFERÊNCIA alvenaria→concreto (parede que morre sobre pavimento de outra planta vira carga linear G/Q nas vigas — o prédio híbrido calculado de ponta a ponta), calculadora de EFEITO ARCO, janelas com peitoril + CONTRAVERGA na elevação e aviso de junta de controle > 15 m
- Interação solo-estrutura: sondagem SPT por camadas → molas de apoio CRV/CRH
(Es = α·K·NSPT — Teixeira & Godoy p/ sapatas; Aoki–Velloso p/ estacas), re-análise
do pórtico sobre apoios elásticos, recalques ELS-QP e distorções angulares
- Incêndio (NBR 14432 + NBR 15200): TRRF automático por ocupação×altura, método
tabular p/ vigas e lajes, método analítico p/ pilares — aba própria e relatório
- Pranchas e detalhamento: planta de forma (cotas entre eixos), corte
esquemático (níveis, pilares, vigas seccionadas e pé-direito cotado), planta de
cargas, ARMAÇÃO DE LAJES em planta (positivas por direção com φ c/ s e comprimento; negativas sobre apoios contínuos com 0,25·ℓ p/ cada lado — Marcus, nervurada e grelha), armação de vigas executiva (ganchos desenhados, cortes pelo diagrama
real com decalagem al §17.4.2.2 e escalonamento, emendas por traspasse §9.5.2,
estribos na distribuição real, QUADRO DE FERROS por posição e editor de
armaduras com aviso de As insuficiente), seções de pilares, PILAR EXECUTIVO em elevação (arranques da fundação, emendas por traspasse em cada pavimento §9.5.2, estribos na distribuição real por tramo, cotas de nível/pé-direito, seção com barras e quadro de ferros do pilar) —
SVG no app, exportação DXF (writer R12 próprio) e PDF vetorial 1:1 com a folha (imprime na escala do carimbo), moldura + carimbo ABNT
(A0–A4, escala automática ou fixa; cotas proporcionais à escala), tabela de aço por
bitola, relatório imprimível e memorial de cálculo completo em PDF (writer PDF
próprio, 15 seções + furos/solo/custo, multipágina)
- Quantitativos com custo: concreto, fôrma e aço por elemento + estimativa de
custo (R$/m³, R$/kg, R$/m² editáveis) e custo por m² de laje
- Produtividade: diagramas N/V/M por barra no inspetor (com valores e combinação
selecionável), salvar/abrir nativos (diálogos do SO no desktop, ⌘S/⌘O), autosave
com recuperação, pé-direito variável por pavimento no gerenciador de níveis
- Copiloto IA: chat integrado que lê o modelo, verifica consistência, roda a análise
e edita a estrutura com aprovação manual de cada mudança (estilo Claude Code) —
modo planejamento (só leitura + plano), mudanças no undo/redo. Dois provedores:
Claude (API) com chave local, ou modelos locais via Ollama (offline/privado)
com download dos modelos dentro do app (qwen3, llama3.1 — barra de progresso)
Rodar
npm install
# navegador (mais rápido p/ desenvolver)
npm run dev # → http://localhost:5183
# app desktop (requer Rust: https://rustup.rs)
npm run tauri dev # janela nativa
npm run tauri build # gera .app/.dmg em apps/desktop/src-tauri/target/release/bundle/
# instalador WINDOWS a partir do macOS (cross-compile):
# brew install llvm lld nsis && cargo install --locked cargo-xwin
# rustup target add x86_64-pc-windows-msvc
PATH="/opt/homebrew/opt/llvm/bin:$PATH" npm run tauri build -- \
--runner cargo-xwin --target x86_64-pc-windows-msvc --bundles nsis
# → target/x86_64-pc-windows-msvc/release/bundle/nsis/HyperFrame_*_x64-setup.exe
# (CI: .github/workflows/release.yml builda mac/win/linux ao criar tag v*)
# versão web (sem Tauri) servida em /app/, ao lado do site em /
# (base relativa: o mesmo dist-web/ também funciona na raiz de um domínio)
npm run build:web # → apps/desktop/dist-web/
npm run serve:web # → http://localhost:4173/ (site) · http://localhost:4173/app/ (app)
# testes e verificação de tipos
npm test
npm run typecheck
Na tela inicial, use “Abrir projeto de exemplo” (edifício residencial de 8 pavimentos)
e clique Analisar.
Na versão web, os projetos ficam no navegador (IndexedDB) com URL própria
(/app/#/p/<uuid>) e aparecem em “Meus projetos”; use Exportar /
Importar arquivo… para trocar .hyperframe.json com o computador. O Copiloto IA,
a lista de recentes e os diálogos nativos são exclusivos do app desktop (src/platform.ts).
Estrutura
packages/engine # núcleo puro TypeScript (zero dependências)
src/model # tipos do edifício, presets NBR 6120/6123, solo, projeto exemplo
src/geometry # geometria 2D, detecção de faces, recorte de polígonos
src/analysis # pórtico espacial: geração, rigidez, skyline LDLᵀ, diagramas
src/nbr # NBR 6118 (materiais, vigas, pilares, lajes, sapatas, flechas,
# ancoragem, estabilidade) · 6123 (vento) · 8681 (combinações)
src/design # laços de dimensionamento + detalhamento (tabela de aço)
src/drawing # pranchas (primitivas neutras → SVG/DXF)
src/dxf # parser (underlay) e writer (R12) de DXF próprios
src/report # memorial de cálculo em PDF (writer PDF próprio, zero deps)
test # 402 testes (âncoras analíticas, normas, equilíbrio global)
apps/desktop # Tauri 2 + React 19 + three.js
src/editor2d # editor de planta SVG (snap, ferramentas, camadas, underlay)
src/viewer3d # visualizador 3D (R3F): edifício, deformada, diagramas
src/panels # inspetor, resultados, relatório, plantas, configurações
src/drawings # visualizador de pranchas (SVG) + exportação DXF
src/wizard # assistente de novo projeto
src/store # Zustand + zundo (undo/redo)
src-tauri # shell nativo (Rust)
site/ # landing page (lista de espera) — ver site/README.md
Documentos
- ROADMAP.md — fases até o lançamento comercial e dívidas técnicas
- BUSINESS.md — mercado, preços (pesquisa jul/2026), licenciamento, go-to-market
- VALIDATION.md — política de validação e o que falta p/ uso em projeto real
Telemetria
O app desktop envia um único evento anônimo por abertura (versão do app e sistema
operacional) via Aptabase, para sabermos quantas pessoas usam o
HyperFrame (DAU/WAU). Nunca são enviados projetos, nomes de arquivo, caminhos ou
qualquer dado pessoal — não existe ID de usuário. Dá para desativar em
Configurações → Privacidade (o app avisa na primeira abertura), e o código é aberto:
apps/desktop/src/telemetry.ts e o registro do plugin em
apps/desktop/src-tauri/src/main.rs. A versão web e
builds sem a chave do Aptabase não enviam nada.
⚠️ Aviso
Software em desenvolvimento (v0.1). Os resultados ainda não passaram por validação
cruzada com softwares consagrados (ver VALIDATION.md) e não substituem a análise e a
responsabilidade técnica de um engenheiro habilitado (ART/CREA).