Skip to content

michaelfutol/futolstructure

Repository files navigation

FutolStructure logo

FutolStructure

FutolStructure is a browser-based structural engineering workbench for reinforced-concrete building layout, gravity load-path review, tributary area visualization, 3D coordination, and solver handoff preparation.

Open the live technical preview  |  Deployment  |  Security

Build Validation Platform Maturity License

Important

FutolStructure is an engineering decision-support and model-preparation tool. It does not replace project-specific analysis, code checks, geotechnical input, detailing, or review and signing by the responsible licensed engineer.

Product Workflow

flowchart LR
    A[Grid and floor intent] --> B[Active structural geometry]
    B --> C[Tributary and gravity load path]
    C --> D[Plans, schedules, and 3D review]
    D --> E[DXF, IFC, STAAD, and ETABS handoff]
Loading

Screenshots

Plan, tributary, and load review

FutolStructure plan and tributary view

3D structural model

FutolStructure 3D structural model

Stair Builder

FutolStructure Stair Builder

Current Capabilities

  • Grid-based RC framing with columns, beams, slabs, cantilevers, corner slab patches, and floor-specific controls.
  • Tributary area and gravity load distribution from slabs to beams, columns, footings, and base reactions.
  • Plan drafting aids including coordinated member tags, grid bubbles, dimensions, ortho measurement, snapping, and lock indicators.
  • 3D review with display schemes, member colors and opacity controls, foundation geometry, slab transparency, and stair geometry.
  • .fstr project save/load with guarded autosave, immutable pre-overwrite revisions, destructive-change review, recovery diagnostics, floor deletion warnings, and persisted member locks.
  • Stair Builder geometry with destination slab openings, DXF footprint output, and 3D review.
  • Reports and schedules for columns, beams, slabs, footings/base reactions, and preliminary design summaries.
  • Coordinated multi-floor DXF drawing packages, IFC2x3, STAAD.Pro, ETABS 22 OAPI, and ETABS-to-SAFE handoff paths.

Solver and BIM Status

FutolStructure uses a shared active-model payload so geometry counts and member intent remain coordinated across export targets.

Target Current status
DXF AutoCAD R12 ASCII (AC1009) exports every floor layout and tributary plan, foundation/base reactions, synchronized schedules, load summary, and preliminary BOQ tables on governed structural layers. Output is parser-audited and round-trip checked with ezdxf; the recovered Olango package also opens in AutoCAD 2025 Core Engine without recovery.
IFC2x3 Active columns, beams, slabs, and storey organization are exported for BIM review.
STAAD.Pro The gravity baseline, frame/plate geometry, beam insertion offsets, and statics balance were validated in STAAD.Pro 2024.
ETABS 22 The OAPI builder creates a dated working copy, assigns the governed mass baseline, runs modal analysis, and exports audit artifacts.
SAFE The supported handoff remains ETABS story export plus governed base reactions; direct browser-authored SAFE models are not claimed.

Validated baselines do not imply final lateral design, detailing compliance, or permit readiness for an arbitrary project. The current reliable envelope is regular orthogonal low-rise RC framing; irregular and transfer behavior requires explicit solver review.

Quick Start

No build step is required for the current static application.

git clone https://github.com/michaelfutol/futolstructure.git
cd futolstructure
python -m http.server 4173

Open http://127.0.0.1:4173/v3/index.html.

Validation

Run the syntax and engine smoke check:

node v3/tools/check-fs.js --no-browser

Run the full browser smoke check with Chrome or Edge installed:

python -m pip install -r v3/tools/requirements-dxf.txt
node v3/tools/check-fs.js

The browser smoke covers initialization, plan geometry, slab ownership, cantilever behavior, persistence and recovery guards, protected-revision restore/download, the 50-revision retention limit, historical .fstr migration, member locking, measurement tools, stair persistence, 3D rendering, coordinated DXF completeness, strict DXF open/audit/save/reopen validation, and export payload parity.

Where AutoCAD 2025 is installed, run the native read gate against a generated package without modifying it:

powershell -File v3/tools/check-dxf-autocad.ps1 -DxfPath "path/to/package.dxf"

Repository Layout

futolstructure/
|-- .github/              Release checks and contribution templates
|-- docs/                 Launch, security architecture, and release notes
|-- v3/
|   |-- assets/           Product identity and screenshots
|   |-- engine/           Extracted structural calculation helpers
|   |-- persistence/      Protected project revision storage
|   |-- tools/            Regression smoke runner
|   `-- index.html        Current application
|-- index.html            Hosted root entry
|-- vercel.json           Static deployment and security headers
`-- README.md

Data and Security Boundary

  • The public technical preview is local-file first and does not yet provide user accounts or cloud project storage.
  • .fstr model data stays in the browser or in files explicitly saved by the user.
  • Experimental client-side AI key panels are disabled for the public preview. Future AI or collaboration features must use an authenticated server boundary and explicit project-data consent.
  • Private project files and native solver artifacts are excluded from source control and Vercel deployments.

See SECURITY.md for vulnerability reporting and docs/AUTH_SECURITY_PLAN.md for the planned Supabase authentication and row-level-security architecture.

Deployment

The custom domain requires its DNS record before it becomes public. See docs/LAUNCH_PLAN.md for the exact record and verification command.

Project Status

The product is under active technical validation. Near-term work focuses on protected .fstr revisions, solver export truth, authenticated cloud projects, stair analytical connectivity, and continued BIM round-trip testing.

Contributions should preserve engineering traceability and avoid claims beyond validated behavior; read CONTRIBUTING.md before opening a pull request.

Author

FutolTech - Engineering & Project Systems

Copyright (c) 2026 Michael Futol. All rights reserved. See LICENSE.

About

Browser-based RC structural modeling workbench for tributary load paths, 3D coordination, schedules, and STAAD, ETABS, and IFC handoff.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors