SVG-to-potrace laser cut path engine
Find a file
jlightner c3783e1680 feat: Built useDebouncedTrace hook with AbortController cancellation, P…
- "app/src/hooks/useDebouncedTrace.ts"
- "app/src/components/ParameterSliders.tsx"
- "app/src/components/SvgPreview.tsx"
- "app/src/views/ImportConvert.tsx"
- "app/src/hooks/__tests__/useDebouncedTrace.test.ts"
- "app/src/App.css"
- "app/src/App.tsx"

GSD-Task: S01/T03
2026-03-26 05:15:43 +00:00
.bg-shell init: GSD project scaffolding for Kerf — 3 milestones, requirements, decisions 2026-03-26 03:55:59 +00:00
app feat: Built useDebouncedTrace hook with AbortController cancellation, P… 2026-03-26 05:15:43 +00:00
docker feat: Created multi-stage Dockerfile.engine with healthcheck endpoint;… 2026-03-26 04:49:38 +00:00
engine test: Added CORSMiddleware to engine, scaffolded Vite+React+TS app with… 2026-03-26 05:05:31 +00:00
.dockerignore feat: Created multi-stage Dockerfile.engine with healthcheck endpoint;… 2026-03-26 04:49:38 +00:00
.gitignore chore: Created engine/ Python project with FastAPI skeleton, all depend… 2026-03-26 04:07:16 +00:00
GSD-INITIATE.md init: GSD project scaffolding for Kerf — 3 milestones, requirements, decisions 2026-03-26 03:55:59 +00:00
README.md chore: Created engine/ Python project with FastAPI skeleton, all depend… 2026-03-26 04:07:16 +00:00
REQUIREMENTS.md init: GSD project scaffolding for Kerf — 3 milestones, requirements, decisions 2026-03-26 03:55:59 +00:00

Kerf

Modular raster-to-vector conversion engine + 2D sign/patch design canvas.

Repository Structure

engine/    — Kerf Engine (standalone API, Python/FastAPI)
app/       — Kerf App frontend (React) [future]
server/    — Kerf App backend API [future]
docker/    — Dockerfiles and compose configs [future]

Kerf Engine

The engine is a self-contained FastAPI service that accepts raster images and returns clean vector output (SVG, DXF).

Quick Start

cd engine
pip install -e ".[dev]"
uvicorn main:app --host 0.0.0.0 --port 8000

API docs available at http://localhost:8000/docs.