Skip to content
pdilyardPublic
forked from hew3d/hew

About

The intuitive, Open Source, cross-platform, solids-first 3D modeler

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

305 Commits

Folders and files

Repository files navigation

Hew

The free, open-source, cross-platform 3D modeler for people who learned on SketchUp — the same draw-and-push/pull way of working, rebuilt on watertight solid objects. Native on macOS, Windows, and Linux, and the same app in your browser.

Download · Run in the browser · User guide · hew3d.com

Hew drawing a rectangle and pulling it into a solid, then the app's tool rail and panels appearing around it; carving a recess and a hole into a block; a trestle table switching between saved scenes, its parts listed in the Outliner, and a tag hidden and shown; orbiting a finished desk set; and a lap around a whole-house framing model


Hew keeps the interaction model that made SketchUp approachable — draw on faces, push/pull, pervasive inference snapping, even the same key bindings — and puts it on top of a stricter foundation:

  • Extruding a closed profile creates a discrete Object. Objects are watertight solids by construction and never weld together implicitly.
  • Combining Objects is always explicit — a boolean union or merge you ask for, never a side effect of geometry touching.
  • Inside an Object, sticky geometry applies: drawing an edge across a face splits it, closed coplanar loops become faces, faces push/pull.
  • No silent repair. Operations that would produce invalid topology fail with a typed error instead of quietly "fixing" your model.
  • An open native format. .hew files are a documented zip container — JSON manifest plus binary geometry buffers. See docs/dev/HEW_FILE_FORMAT.md.

Get Hew

Native desktop apps for macOS, Windows, and Linux — the recommended way to use Hew — are on the download page and the releases page; desktop builds update themselves in place. The same app also runs in any WebGL2-capable browser at app.hew3d.com, with nothing to install.

See docs/ROADMAP.md for what's shipped and what's planned.

Highlights

  • Drawing tools (line, rectangle, circle, arc) with on-face sketching, guides, and a measurements box that accepts typed, unit-aware input
  • Push/pull with a live swept-solid preview; move, rotate (arbitrary axis), and scale with inference locking
  • Boolean union, subtract, and intersect between solids
  • Materials with texturing, per-face painting, and translucency
  • Tags, an object tree, and per-Object solid/watertight reporting
  • SketchUp 2017 keyboard shortcuts
  • Open and save SketchUp .skp files as documents (the current 2026 format and the 2017 one), with names, hierarchy, materials, tags, guides, and scenes carried both ways; Model Health and Make Solid show and close what an imported model has that isn't solid
  • Import: COLLADA .dae, glTF, STL, and .skp into an open document
  • Export: SketchUp .skp, glTF, STL, 3MF, USDZ, SVG line drawings — see docs/INTEROP.md
  • Print to paper or PDF: what you see, or a drawing at an exact scale tiled across sheets with trim marks and a scale bar, as a bitmap or as vector line art; headless too
  • Autosave and crash recovery, structured debug logging, and deterministic session record/replay (docs/dev/DIAGNOSTICS.md)

Architecture in one paragraph

The geometry kernel — half-edge meshes, Objects, booleans, undo, serialization — is pure Rust with no UI, I/O, or network dependencies, compiled to WebAssembly and run inside the webview on every platform, desktop included. The UI is a single TypeScript + React codebase rendering through three.js on a WebGL2 baseline. The desktop shell is Tauri; the web shell is a static build of the same app. The full picture, including the data model and the reasoning behind these choices, is in docs/agents/ARCHITECTURE.md.

Building from source

Prerequisites: Rust (version pinned by rust-toolchain.toml), wasm-pack, Node.js with pnpm, and for the desktop shell the Tauri platform prerequisites.

# Build and test everything the verification gate covers
scripts/verify.sh

# Run the app in a browser
pnpm --dir app dev

# Run the desktop shell
pnpm --dir shells/tauri dev

Both dev and build compile the Rust kernel to WASM automatically, rebuilding only when the kernel sources change. To build it on its own (or if wasm-pack isn't on your PATH and you want to run it manually):

wasm-pack build crates/wasm-api --target web --out-dir ../../app/src/wasm/pkg

Documentation

The docs/ tree is organized by audience: the top level is for users, docs/dev/ for people working on Hew or its formats, and docs/agents/ holds the exhaustive references AI agents work from.

For users:

Document What it covers
docs/ROADMAP.md What works now and where Hew is going
docs/INTEROP.md Import/export formats and their limits
docs/SELF_HOSTING.md Running your own Hew web app and relay
docs/API_GUIDE.md Driving Hew from a program or an AI agent — start here
docs/API_REFERENCE.gen.md Every API command: parameters, results, refusals

For developers:

Document What it covers
docs/dev/DEVELOPMENT.md Contributor guide: setup, rules, testing
docs/dev/ARCHITECTURE.md Architecture orientation: data model, crates, invariants
docs/dev/HEW_FILE_FORMAT.md The open .hew file format specification
docs/dev/DIAGNOSTICS.md Debug logs, session recording, bug reports
docs/dev/BRAND.md The mark, wordmark, and color system

For AI agents (exhaustive references; code cites them by section):

Document What it covers
docs/agents/ARCHITECTURE.md Data model, kernel design, crate topology — in full
docs/agents/HEW_API.md The API protocol specification
docs/agents/ROADMAP.md The detailed feature inventory behind the roadmap

Contributing

Contributions are welcome — see CONTRIBUTING.md. Note the project's licensing wall: nothing derived from the SketchUp SDK may enter this repository or its dependency chain. SketchUp import is powered by OpenSKP, a clean-room reader.

License

Hew is licensed under the GNU AGPL-3.0-only, together with the Hew Plugin API Exception — an additional permission that lets you write and distribute closed-source plugins, as long as they interact with Hew solely through the documented Plugin API. The core stays copyleft, including over network use; the plugin ecosystem is open to commercial authors.

SketchUp is a trademark of Trimble Inc. This project is independent of and not affiliated with Trimble in any possible way.

About

The intuitive, Open Source, cross-platform, solids-first 3D modeler

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages