SOURCE / PINNED RELEASE
Made of little things.
Nappakura
- Release
- a75ca0f8b596…
- Author-recorded commit
- 4463126213fa…
- License
- LICENSE
- Author’s source reference
- nostr://npub182jczunncwe0jn6frpqwq3e0qjws7yqqnc3auccqv9nte2dnd63scjm4rf/wss%3A%2F%2Fgit.napplet.soy%2F/n-8db03001b62
Archive hash verified: b448d77b767ae754…. The source-to-build association is the author’s claim; it has not been independently rebuilt.
# Nappakura
Purpose: turn a small polygon mesh into editable, correctly scaled paper patterns.
Workflow: OBJ / ASCII or binary STL → linked 3D and 2D selection → unfold → edit
seams, tabs, placement and print settings → vector PDF through the host file rail.
Native `.nappakura` JSON projects preserve edits. PDO and texture mapping are out of scope.
## Boundary contract
- `fs` is optional: host-owned import, chunked reads and session export. Without it,
the bundled example and all editing/preview tools remain usable; file controls explain absence.
- `storage` is optional: explicit save/restore of a small local draft, with quota/error feedback.
- `config` is optional: host settings for drawing preferences, with local defaults.
- No identity, network, relay, backend or theme requirement. Optional agent tools
use the local soy.webmcp/1 experiment described in MODELLING.md.
- `requires: []`; all geometry, rendering and PDF generation happen inside the iframe.
- Host file quota: 10 MiB total session copies; 256 KiB per operation. Imports limited
to 8 MiB and 2,000 triangles for predictable first-version responsiveness.
## Geometry contract
Triangulate simple OBJ polygons, weld coincident vertices conservatively, reject
invalid indices/non-finite data, remove degenerate/duplicate triangles and report
open/non-manifold edges. Orient connected faces consistently. Automatic unfolding
builds a spanning forest, refusing overlapping face placements. Manual joins refuse
cycles and overlapping results. Seam changes rebuild and repack the pattern.
All drawing coordinates are millimetres; preview and PDF share drawing primitives.
Tabs are generated once per cut edge with matched numbers. Intersecting tabs are
shortened or omitted with a visible warning. Export refuses off-page or overlapping
pieces. No automatic rescaling to fit paper. Undo/redo covers document edits.
## Visual direction
Considered a warm craft desk and a precise technical drafting workspace. Chose
the latter: slate blue 3D stage, ivory-white paper, dark ink, blue selection,
orange seam highlights, small monospaced measurement labels and restrained square
controls. The tool opens on a faceted gem and its real printable net. System fonts,
no decorative external assets, no continuous animation. App-owned colors in both
host themes. Cut / mountain / valley distinguishable by line patterns.
Desktop: linked split views with a compact inspector. Compact portrait: switch
between Model, Pattern and Tools; controls remain scrollable and touch sized.
Below 280 × 280: a useful enlarge-frame notice preserves the document. Verify
200×160, 320×560, 900×600, full screen and touch portrait/landscape. Numeric piece
placement and native selection controls supplement pointer interaction.
States: example on startup; busy file operation feedback; actionable import/export
errors; warnings for mesh and print issues; signed-out fully supported; missing
optional domains affect only file, draft or host-settings operations.
## Verification plan
Geometry/import/PDF regression tests, required guidance/type/build/conformance,
soyLI hosted import/edit/export, optional-domain fallbacks, four frame sizes and
touch emulation. Render and inspect a generated PDF. Independent shell and real
phone coverage reported separately. Stop the owned preview when testing ends.
## Modelling reference — 2026-11-13
Stable polygon/vertex IDs and derived edge IDs, millimetre coordinates and atomic
validated commands serve the toolbar and experimental shell tools. The polygon
model produces the existing triangle renderer and paper pattern. Geometry changes
rebuild seams/layout; undo restores them. V2 projects preserve editable topology;
v1 projects still open. Keep the existing slate/ivory drafting palette and add a
compact selection toolbar and numeric modelling inspector. Fullscreen agent/file
prompts belong to the shell. No direct browser agent or host DOM access in this app.
