Skip to content
hew3dPublic

About

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

Resources

Code of conduct

Contributing

Security policy

Stars

210 stars

Watchers

5 watching

Forks

Latest commit

 

History

386 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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


Opens and saves every version of SketchUp, from SketchUp 3 through SketchUp 2027. A .skp file of any release (3 to 8 and 2013 to 2027) opens as a Hew document and saves back in its own release, and Save As writes any of them, through the clean-room Skpwright reader and writer.

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; the macOS and Windows apps and the Linux AppImage, .deb, and .rpm can install updates themselves, and Flatpak, Arch, and Gentoo installs show the command that updates them (Linux update help). 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 of every version, from SketchUp 3 through 2027, as documents: releases 3 to 8 and 2013 to 2020 open and save back in their own release, and the container that SketchUp 2021 and later save (2021 through 2027) opens and saves back as that container, with names, hierarchy, materials, tags, guides, and scenes carried both ways; Save As writes any of them; 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 (any version, 3 through 2027), 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. They need wasm-pack on your PATH; scripts/install-wasm-pack.sh installs the pinned version. The first build takes several minutes.

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 and export are powered by Skpwright, a clean-room reader and writer.

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.

The brand assets in brand/ (logo, mark, and icons) are licensed separately under CC BY 4.0.

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

210 stars

Watchers

5 watching

Forks

Releases

Packages

Contributors

Languages