BROIDERS

STUDIO OS

A self-hosted operations console for a one-woman machine-embroidery studio. Orders in, stitches out, money counted — one app instead of a spreadsheet, a paper notebook, and a separate digitizing program.

One machine · one operator · zero compromise
What it is
Studio operations console
Signature feature
In-house digitizer
Output
.vp3 stitch files
Runs on
A home server, LAN only

Machine embroidery has two halves: running the business and making the stitch file. Off-the-shelf software does one or the other, and the digitizing half is expensive and built for a shop with staff. BROIDERS does both halves for one person — the queue, the customer book, the revenue, and a digitizer that turns a word or an SVG into real stitch geometry the machine will sew.

Four screens follow, each shown as it actually renders. The data in them is sample data, but the interface is the real one.

01

Home — the console

Not a dashboard full of numbers you didn't ask for. Three doors and a status light: is the machine ready, and where are you going? The pill in the top-right is live — it turns over when the backend stops answering.

studio-os.example/ MOCKUP · SAMPLE DATA
ONE MACHINE · ONE OPERATOR · ZERO COMPROMISE

STITCH THE FUTURE

The studio OS for a one-woman embroidery powerhouse. Track orders, manage designs, count the cash — all in one neon-lit console.

Enter the studio Open designs

The Console

// pick a section
>

Orders

Every job from entry to done — status, due dates, totals. open →
◈

Design

Type a word, preview the real stitches, export the file. open →
$

Cash Money

Monthly gross, the yearly take, and the goal line. open →
02

Order tracking

The working queue. Four counters across the top, the order list in the middle, and the customer book beside it — because most jobs in a studio like this are the same people coming back. Every order carries its line items, its due date, its notes, and the files that belong to it.

studio-os.example/orders MOCKUP · SAMPLE DATA
STUDIO OS / ORDERS

Order queue

+ New customer + New order
Open orders
5
In progress
2
Done this month
7
Customers
14

Orders

Open · 5 History · 31
OrderCustomerStatusDue Total
#1043 J. Alvarez Tack Shop · Cedar Ridge In Progress 2026-09-04 $180.00 edit →
#1042 M. Okafor Retail · LOCAL New 2026-09-02 $65.00 edit →
#1041 Sunridge Stables Tack Shop · Sunridge In Progress 2026-08-30 $420.00 edit →
#1040 R. Vega Retail New 2026-09-08 $95.00 edit →
#1039 T. Brandt Other · LOCAL New 2026-09-11 $150.00 edit →

Customer book

repeat business
  • J. Alvarez (503) 555-0142 + order
  • Sunridge Stables orders@sunridge.example + order
  • M. Okafor (971) 555-0118 + order
  • R. Vega r.vega@example.com + order
  • T. Brandt (360) 555-0173 + order

// the Open queue. History holds finished jobs and adds a copy → action per row.

03

Digitizing

The reason the app exists. Type a word, or drop in an SVG, and the backend computes actual stitch geometry — satin columns and fill rows, with jump stitches where the needle travels. The preview you see is not a picture of the artwork; it is the stitch path itself, drawn at 0.4 mm thread width so the coverage on screen is the coverage on fabric. Export .vp3 or attach it straight to an order.

studio-os.example/design MOCKUP · SAMPLE DATA
STUDIO OS / DESIGN

Digitizer

Lettering or a simple SVG logo — pick a mode, preview the actual stitches, export .vp3 or attach it to an order.

Text Logo

Stitch preview

// block · manual · cyan
Est. stitches 2,439
Size 122 × 24 mm
Thread colors 1

Digitize

Stitch profile Manual (no profile)
+ New profile ↥ Upload font
Letters or word BROIDERS up to 16 characters
Stitch font Block
Stitch type
Satin Fill
Height (mm) 24
Row spacing (mm) 0.4
Max stitch (mm) 3
Outline stitch (mm) 1.8
Thread

↧ Download .vp3 ◈ Save to order record

// text mode. The preview above is genuine fill-stitch geometry, not a rendering of a font.

studio-os.example/design — logo mode MOCKUP · SAMPLE DATA

Stitch preview

// cedar-ridge-mark.svg · 30 mm
⚠ shape #4 is thinner than 1 mm — dropped
Est. stitches 300
Size 30 × 30 mm
Thread colors 3

Digitize logo

↥ Upload SVG
Width (mm) 30
Shapes (stitch type)
#1 stroke
Satin Fill
#2 fill
Satin Fill
#3 fill
Satin Fill

↧ Download .vp3 ◈ Save to order record
✓ attached to order #1043 DONE

// logo mode. Each SVG shape becomes its own colour block; hovering a row outlines that shape in the preview.

04

Cash Money

Two running totals and one honest bar chart. Every order counts toward the month and the year it was entered — no reclassifying, no adjustments, no way to make a slow month look better than it was. The dashed line is the monthly goal.

studio-os.example/cash-money MOCKUP · SAMPLE DATA
STUDIO OS / CASH MONEY

The take

Every order counts toward the month and the year it was entered. Two running totals, one honest bar chart.

This month · AUG 2026
$2,685.00
▲ $685.00 112% of goal
This year · 2026 YTD
$14,065.00
all-time $41,920.00

Monthly gross · 2026

// by order entry date
goal $2,400.00
$1,240
$980
$1,610
$1,820
$1,780
$1,950
$2,000
$2,685
JAN FEB MAR APR MAY JUN JUL AUG SEP OCT NOV DEC

Material cost & net margin

COMING SOON
Thread & metallic—
Stabilizer & backing—
Blanks & garments—
Needles & machine time—
Net margin—

goes live once per-run cost inputs are added to the order form

05

Under the hood

Small on purpose. One person has to maintain this, so there is no message queue, no cluster, and no cloud bill — a single Python process serving an API and a built frontend from the same origin, backed by one SQLite file.

Backend

FastAPI on Python, SQLModel over SQLite, dependencies pinned with uv. Serves the API and the built frontend from one origin — no CORS, no second process.

Digitizer

Pure Python. Glyph outlines and SVG paths become stitch runs — satin columns, scanline fills, jump stitches — written out as .vp3 for a Husqvarna Viking machine.

Frontend

React and TypeScript in strict mode, built with Vite. No component library — the design system in this document is hand-written CSS against a token file.

BROIDERS Studio OS — feature showcase. Interface rendered with the production stylesheet; all orders, customers, and figures shown are fabricated sample data.