Skip to content

Releases: GuildMasterDev/Carpenter

Carpenter v1.1.0 — Electron + PWA

16 Apr 16:07
@DavidLiedle DavidLiedle
v1.1.0
aadee68

Choose a tag to compare

View all tags
Carpenter v1.1.0 — Electron + PWA Latest
Latest

Carpenter now runs three ways: in any browser, as a packaged Electron desktop app, or installed as an offline-capable Progressive Web App.

🌐 Live demo / PWA install: https://guildmasterdev.github.io/Carpenter

What's new in 1.1.0

🖥 Electron desktop app

  • main.js opens a hardened 1200×800 BrowserWindow (contextIsolation: true, sandbox: true, nodeIntegration: false)
  • preload.js exposes a minimal window.carpenter namespace via contextBridge
  • External links open in the system browser
  • macOS-style window-all-closed behavior
npm install
npm start

📦 electron-builder packaging

Cross-platform installers configured under build in package.json:

npm run dist:mac      # dmg + zip for x64 and arm64
npm run dist:win      # nsis installer + portable for x64
npm run dist:linux    # AppImage + deb for x64

App ID: dev.guildmaster.carpenter. Output lands in dist/.

📱 Progressive Web App

  • manifest.json with name, theme/background colors, standalone display, and 192/512 icons (any + maskable)
  • sw.js cache-first service worker with versioned cache (carpenter-v1); pre-caches the app shell on install, evicts old caches on activate, and falls back to cache when offline
  • Apple touch icon, status bar styling, and apple-mobile-web-app-capable
  • Installable from any Chromium-based browser or Safari — once cached, Carpenter works fully offline

🎨 Icons

  • Wood-themed saw silhouette in PNG (16, 32, 48, 64, 128, 192, 256, 512, 1024), icon.ico for Windows, icon.icns for macOS, and editable source SVG

🎯 Compatibility

  • The single-file browser experience is unchanged — both Electron and PWA layers are purely additive
  • Service worker registration is automatically skipped under file:// (Electron's default protocol) so the desktop app never sees an SW error

Disclaimer

Carpenter is a reference and estimating aid — not a substitute for professional engineering, local building codes, or a licensed contractor.

Assets 2
Loading

Carpenter v1.0.0

16 Apr 15:56
@DavidLiedle DavidLiedle
v1.0.0
ac90603

Choose a tag to compare

View all tags
Carpenter v1.0.0

First stable release of Carpenter — an interactive construction carpentry resource and tool suite. Single index.html, vanilla JavaScript, no dependencies, no build system.

🌐 Live demo: https://guildmasterdev.github.io/Carpenter

What's in 1.0.0

📚 Resources

Curated, categorized reference cards covering:

  • Framing — wall framing basics, header sizing, load-bearing walls, balloon vs platform
  • Joinery — joint catalog, mortise & tenon, dovetails, pocket screws, joint strength
  • Roofing — rafter layout, ridge beam vs board, hip & valley, bird's mouth
  • Decks & Stairs — stringer calculation, IRC stair code, ledger attachment, joist spacing
  • Tools — essential hand tools, power tools, layout tools, safety equipment

Each card links to a real external resource (Fine Homebuilding, JLC, Family Handyman, AWC, OSHA).

🧮 Calculators

Live-updating, real construction math with full math breakdowns and copy-to-clipboard:

  • Lumber Estimator — studs, plates, headers from wall geometry and openings
  • Stair Calculator — risers, treads, run, stringer; live SVG side view; IRC code checks
  • Roof Pitch — bidirectional rise/12 ↔ degrees; SVG triangle; slope factor
  • Board Foot Calculator — with cost estimate
  • IRC Span Tables — R502.3.1 (floor) and R802.5.1 (ceiling) for SPF / DF / SYP at 12 / 16 / 24" OC

📖 Reference

Field-reference tables:

  • IRC nail schedule (R602.3) for framing, sheathing, subfloor, roof
  • Nominal vs actual lumber dimensions (imperial + metric)
  • Common carpentry angles with pitch and field context
  • Fastener guide (nails, screws, lags, hangers, ties, anchors)
  • Wood species comparison

🪜 Wall Framing Visualizer

Live SVG front-elevation drawing of a framed stud wall:

  • Configurable wall length, height, stud spacing
  • Add / remove door and window openings with editable RO size and sill height
  • Renders plates, common studs, end studs, king studs, trimmer (jack) studs, headers, cripples (above headers), rough sills, and sill cripples
  • Color-coded with on-canvas legend
  • Hover any member for name, size, and structural purpose
  • "Materials List" button generates a full stock cut list, copy-to-clipboard

🎨 Polish

  • Dark theme with warm wood accents
  • SVG-data-URI favicon (saw silhouette)
  • Open Graph + Twitter card meta with social image
  • Responsive layout (mobile-friendly)
  • Print stylesheet (Ctrl+P / ⌘+P)
  • Smooth tab transitions

🚀 Deployment

  • GitHub Actions workflow auto-deploys repo root to GitHub Pages on every push to main

Tech

  • Single index.html with inline CSS and JS
  • Vanilla JavaScript — no React, no frameworks, no npm packages at runtime
  • Inline SVG for all diagrams and visualizations

Disclaimer

Carpenter is a reference and estimating aid — not a substitute for professional engineering, local building codes, or a licensed contractor.

Loading