📖 ShopCraft Free & ShopCraft Pro — Complete User's Guide

1. Welcome & Overview: ShopCraft Free vs. ShopCraft Pro

ShopCraft (shopcraftapp.com & shopcraft.app) combines a high-yield 1D Linear Board & 2D Sheet Goods Cut Optimizer with a complete Workshop Lumber, Hardware & Tool Inventory, Live Regional Store Pricing by ZIP Code, and an interactive 📱 Send-to-Phone Store Shopping List.

Plan Comparison: ShopCraft Free ($0) vs. ShopCraft Pro ($9.99/mo or $69.99/yr)

2. Top Header Bar, Store ZIP Code & 12 Supported Retailers

The compact top workshop bar keeps your global settings, live shop valuation KPIs, and quick actions accessible from every tab without wasting screen space:

• Shop / Inventory Name: Customize your workshop's name (e.g., Main Woodworking Shop), which appears on printed cut sheets, shopping lists, and insurance reports.
• Store ZIP & Preferred Store / Outlet PRO: Enter your 5-digit US ZIP code (e.g., 77340) and choose your local retailer. Click 🔄 Update Store Prices to refresh regional pricing across your lumber catalog, hardware inventory, and tool replacement values.
• Top Action Buttons:
  • 🔄 Update Store Prices: Refreshes web prices for Lumber, Hardware & Shop Tools at your selected ZIP code and retailer.
  • 📱 Send List to Phone: Opens the QR code, SMS, Email, and live Smartphone Aisle Checklist modal for your shopping list.
  • 💎 Plans & Pricing: Displays the 3-column side-by-side comparison of ShopCraft Free ($0), ShopCraft Pro Monthly ($9.99/mo), and ShopCraft Pro Annual ($69.99/yr).
  • 👤 Sign In: Opens the Supabase Cloud Account modal to sign in, create a free account, or manage your subscription.
  • 🖨️ Print Report: Prints a formatted Cut Sheet, Shopping List, and Complete Workshop Insurance Valuation Report.
  • 📖 User's Guide: Opens this reference manual in a separate window.

12 Supported Lumber, Hardware & Tool Retailers

3. Tab 1: 🪚 1D Linear Board & 2D Sheet Goods Cut Optimizer

The 🪚 Cut Optimizer (Boards & Sheets) tab calculates the highest-yield, lowest-waste cutting layout for both dimensional boards (2x4, 1x6, hardwoods) and sheet goods (4'×8' plywood, MDF, melamine).

Compact Dark Dashboard Header

Directly below the title line, four compact dashboard cards display your real-time cut plan metrics in a single row: Cut Pieces Placed, Boards & Sheets Used (broken down into On-Hand vs. Store Needed), Material Yield / Waste %, and Estimated Store Wood Cost ($).

Quick-Load Samples, On-Hand Wood Import & Pro Power Bar

• Quick Load Samples: Click 📏 Linear Board Sample, 📐 4×8 Sheet Sample, or 🪵 Workbench (Boards + Sheet) to load a ready-made project and see the optimizer in action immediately.
• 📥 Pull from My On-Hand Wood: Imports your existing On-Hand Lumber & Sheet inventory into the Available Stock list (with fixed quantities) so the optimizer uses the wood already sitting in your shop before telling you to buy more at the store!
• 📋 Paste Excel PRO: Paste rows directly from Microsoft Excel, Google Sheets, or CSV files to populate your cut list in seconds.
• 🪚 Kerf: Enter your saw blade kerf thickness (default 1/8"; supports fractions like 3/32" or decimals like 0.125").
• 💲 Optimize for Cost PRO: Evaluates multiple store board lengths (e.g., 8' vs. 10' vs. 12') to find the lowest total dollar cost rather than yield alone.
• 🔢 Prioritize Stock Order PRO: Forces the optimizer to consume stock boards/sheets in the exact priority order you assign (1, 2, 3...).
• 🌾 Match Grain Dir PRO: Enforces grain orientation (Lengthwise, Widthwise, or No Grain / Rotate Freely) on 2D plywood and veneer sheet cuts.
• 🪚 Trim Ends & Sides PRO: Opens the collapsible trim drawer to deduct factory-damaged or out-of-square board ends and sheet edges (Left, Right, Top, Bottom) before placing cuts, and sets your Min Usable Offcut Length (default 12").
• 📏 Show Cut Lines: Toggles the red numbered guillotine saw-cut lines and step badges on the visual SVG diagrams.

Two-Way Shop Inventory & Shopping List Actions

• ♻️ Save Offcut to On-Hand Wood PRO: On any board or sheet diagram card with a usable leftover piece, click this button to add that exact offcut dimension directly into your On-Hand Lumber Inventory!
• 📉 Deduct Used Wood from Inventory PRO: Subtracts the On-Hand boards/sheets consumed by your cut plan from your shop inventory.
• 🛒 Send Needed Wood to Shopping List →: Sends all store boards/sheets required by your cut plan straight to your Smart Store Shopping List.

4. Tab 2: 🪵 Lumber Inventory & Editable Price Catalog

On-Hand Shop Lumber Inventory (Full Boards, Full Sheets & Cut Pieces)

• Record Full Board (8'/10'/12'), Full Sheet (4'×8'), Cut Piece / Board Offcut, and Sheet Remnant / Panel items in your shop racks.
• Nominal Size Auto-Fill: Selecting a nominal size (e.g., 2x4, 1x6, 4/4 Hardwood, 3/4" Plywood) automatically fills the true actual thickness and width and calculates the unit value from your catalog.
• ShopCraft Free Quota: Includes up to 10 On-Hand Wood items. Upgrade to ShopCraft Pro for unlimited lumber tracking and live regional store pricing.

Editable Lumber & Sheet Goods Price Catalog

• Customize standard and specialty lumber sizes, per-foot rates, and 8' board / 4'×8' sheet prices inline.
• Click 🔄 Update Store Lumber Prices (PRO) to pull regional store prices for your ZIP code, or click + On-Hand on any catalog row to add it to your shop inventory.

5. Tab 3: 🔩 Hardware Inventory & 🗄️ Storage Locations / Bins Directory

Tracking Hardware by Exact Cabinet, Drawer & Bin Location

• Record screws, bolts, Euro hinges, drawer slides, casters, T-tracks, glues, finishes, and sandpaper by exact Storage Location (Cabinet / Drawer / Bin) (for example: 50 × #8 2" Wood Screws in Cabinet 1, Drawer 2).
• Use 📍 Filter Location at the top of the table to immediately see every fastener or hardware item stored inside a specific cabinet or drawer.
• ShopCraft Free Quota: Includes up to 10 Hardware items across up to 3 Storage Locations. Upgrade to ShopCraft Pro for unlimited hardware items, unlimited storage bins, and live store price lookups.

🗄️ Shop Storage Locations, Cabinets, Drawers & Bins Directory

• Define every storage unit in your shop by Cabinet / Storage Unit, Drawer / Bin #, Bin / Drawer Size (with built-in dimension presets for Small/Medium/Large Bins and Shallow/Medium/Deep Drawers), and Typical Contents.
• Editing a location's name or bin number inline automatically updates every hardware item assigned to that location.

6. Tab 4: 🛠️ Shop Tools & Equipment (Brand + Model # Auto-Fill)

• Add via Top Bar or Inline Table Row: Add tools using the top form or click + Add Row in Table to type Brand and Model # directly inside the table.
• Homeowner's & Workshop Insurance Documentation: Your total tool replacement valuation updates automatically in the top KPI strip and prints in an itemized table when you click 🖨️ Print Report.

7. Tab 5: 🛒 Smart Store Shopping List, 📱 Send to Phone & Valuation

Smart Local Store Shopping List PRO

• Click 🔄 Pull Needed Wood from Cut Optimizer to import the exact store boards and sheets required by your active cut plan (after subtracting any On-Hand wood already used).
• Add extra fasteners, glue, blades, or supplies using the quick-add bar—complete with the target Put-Away Location (Cabinet / Bin) so you know exactly which drawer each item goes into when you return from the store.

📱 Send to Phone Modal (QR Code • SMS • Email • Printable PDF • Live Mobile Checklist) PRO

• Click 📱 Send List to Phone in the top header (or inside the Shopping List card) to open the mobile sync window:
  1. Scan QR Code with Phone Camera: Point your iPhone or Android camera at the QR code to open your interactive mobile aisle checklist right on your phone in the store aisle.
  2. Send via Text (SMS), Email, or Copy Link: Send the interactive checklist link via text message or email in one click.
  3. Print / Save 1-Page Store Run PDF: Generates a clean printable PDF checklist sorted by category with estimated store prices and put-away bin locations.
  4. Live Smartphone Aisle Preview & 1-Click Restock: Check off items as you load your cart, then click ✅ Add Checked to Shop Inventory (or 📦 Add Checked Items to Inventory) when you get back to the shop to automatically add those purchased boards and hardware items into your On-Hand Inventory!

8. 👤 Cloud Account Sync, Subscription Billing & Backups

• 👤 Cloud Account Sign-In / Sign-Up: Click 👤 Sign In in the top header to create a free account or sign in with your email and password. Your account connects to the ShopCraft Cloud Database (Supabase PostgreSQL with Row-Level Security) so your subscription status and shop data are protected.
• 💎 Managing Your Subscription: Click 💎 Plans & Pricing at any time to upgrade to ShopCraft Pro Monthly ($9.99/mo) or ShopCraft Pro Annual ($69.99/yr — Save 42%). You may cancel anytime; Annual plans include a 14-day money-back guarantee ([email protected]).
• Local JSON & CSV Backups: On the 🛒 Shopping List & Valuation tab, use 📥 Export Backup (.shopcraft.json), 📊 Export CSV Spreadsheet, or 📤 Import Backup (.json) at any time to keep local snapshots of your workshop inventory.