# Blocksmith Studio

**Free, local crown hat-block geometry for working hat makers.**

Blocksmith Studio V1 is deliberately small: choose a head shape, hat size,
overall crown height, and one of four crown families, then create a printable
STL in the browser. A separately modeled matching stand and a very small
optional fit-check are included.

The V1 web app does not include brim-block creation, a Tool Cabinet, or a
mandatory calibration workflow. Those experiments continue separately until
they have been proven by real prints.

## V1 features

- Round, oval, and long-oval head shapes with circumference-preserving bases.
- US and metric input.
- Four dome/shoulder families: full dome, rounded open, classic open, and
  shallow dome.
- Complete, watertight binary crown STL generation entirely on the device.
- Five governed BS-1.0 stand sockets: Ø25.4 mm × 25.4 mm deep at the center and
  ±40 mm cardinal offsets.
- Matching stand download with Ø24.606 mm × 23.813 mm working pegs.
- Optional low-filament BS-1.0 fit-check for troubleshooting.
- Local save/open profile files. No account and no upload.
- Optional Venmo tip jar plus community links.

## Run and verify

Requires Node.js 20 or newer. No package installation is needed.

```bash
npm run check
npm test
python3 -m unittest discover -s tests -v
npm run build
npm run dev -- --host 0.0.0.0 --port 4173 --strictPort
```

The production-ready offline bundle is written to `dist/`. Open the local
server address shown in the terminal; crown STL creation remains entirely in
the browser.

## Geometry rule

The chosen crown height is measured from the base plane to the highest point at
the top center. All four profiles preserve that exact overall height and the
same selected base circumference. The top is continuously domed rather than
cut off by a flat plateau.

## Prototype boundary

The stand and generated files are printable engineering prototypes. Printer,
material, slicer, and environmental behavior must be evaluated by the user.
Nothing in V1 is certified for steam, heat, load-bearing, or production use.

## Authorship

Blocksmith was conceived by **Rich Henson** and developed in collaboration with
**Codex by OpenAI**. It is offered freely because making and restoring hats
already costs too damn much.

See [Simplified V1 Release](docs/SIMPLIFIED_V1_RELEASE.md),
[Printer Compatibility](docs/PRINTER_COMPATIBILITY.md), and
[Print Troubleshooting](docs/PRINT_TROUBLESHOOTING.md).
