Raw schema
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Project name, e.g. 'Cedar planter 24 x 12 in'"
},
"parts": {
"description": "Every piece, for anything other than a cedar picket planter. Leave this out when picket_planter is set. If both are sent, picket_planter is used.",
"maxItems": 150,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "e.g. 'Long side' or 'Leg'"
},
"material": {
"type": "string",
"minLength": 1,
"maxLength": 60,
"description": "e.g. '2x4', '1x6 cedar', 'cedar fence picket', '3/4 plywood'"
},
"size": {
"type": "array",
"prefixItems": [
{
"type": "number",
"exclusiveMinimum": 0,
"maximum": 600
},
{
"type": "number",
"exclusiveMinimum": 0,
"maximum": 600
},
{
"type": "number",
"exclusiveMinimum": 0,
"maximum": 600
}
],
"items": false,
"minItems": 3,
"maxItems": 3,
"description": "Real size in inches along width (x), depth (y), height (z)"
},
"at": {
"minItems": 1,
"maxItems": 200,
"type": "array",
"items": {
"type": "array",
"prefixItems": [
{
"type": "number",
"minimum": -600,
"maximum": 600
},
{
"type": "number",
"minimum": -600,
"maximum": 600
},
{
"type": "number",
"minimum": -600,
"maximum": 600
}
],
"items": false,
"minItems": 3,
"maxItems": 3
},
"description": "Required. Where each copy sits: its lowest corner [x, y, z] in inches, x across, y front to back, z up. size is in the same axes (x, y, z). Without positions there is no drawing, no 3D view and no blueprint views. One entry per copy. Example, a 24 x 12 in planter 11.25 in tall: front [0,0,0], back [0,11.25,0], left [0,0.75,0], right [23.25,0.75,0]."
},
"qty": {
"description": "Not needed: copies are counted from 'at'",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"step": {
"description": "Assembly step (1-based) this piece goes on in, matching 'steps'",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"search": {
"description": "What to type into a store search for this material, e.g. 'cedar fence picket 6 ft' or '1x6x8 cedar board'. Send it when the default wording may not find the right lumber.",
"type": "string",
"maxLength": 80
}
},
"required": [
"name",
"material",
"size",
"at"
]
}
},
"picket_planter": {
"description": "Cedar fence-picket planter. When set, Divux designs the pieces. For any other project, omit this and send parts.",
"type": "object",
"properties": {
"length": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 80,
"description": "Outside length in inches. 36 for a 3 ft box, 48 for 4 ft, 60 for 5 ft. Not rounded."
},
"width": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 60,
"description": "Outside width in inches. Rounded to whole 5 1/2 in pickets: 12 becomes 11, 18 becomes 16 1/2."
},
"courses": {
"type": "integer",
"minimum": 1,
"maximum": 4,
"description": "How many pickets high the walls are. 3 for the low 4 ft box, 2 for the raised and tall boxes."
},
"leg_below": {
"type": "number",
"minimum": 0,
"maximum": 48,
"description": "How far the legs stick out below the walls, in inches. 1 for the low box, 6.5 for the raised box, 20 for the tall box."
}
},
"required": [
"length",
"width",
"courses",
"leg_below"
]
},
"stock": {
"description": "Board lengths or sheets you'd buy, with your price estimates. Without it, divux uses common US store lengths and shows no prices.",
"maxItems": 40,
"type": "array",
"items": {
"type": "object",
"properties": {
"material": {
"type": "string",
"maxLength": 60
},
"length": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 600,
"description": "Board length, or sheet length, in inches"
},
"width": {
"description": "Sheet width in inches",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 120
},
"price_estimate": {
"description": "Your estimate in USD for one",
"type": "number",
"minimum": 0,
"maximum": 10000
}
},
"required": [
"material",
"length"
]
}
},
"extras": {
"description": "Screws, nails, glue, finish, and tools needed",
"maxItems": 60,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"kind": {
"type": "string",
"enum": [
"hardware",
"tool",
"supply"
]
},
"qty": {
"type": "integer",
"minimum": 1,
"maximum": 10000
},
"search": {
"description": "What to type into a store search, e.g. 'Titebond III exterior wood glue' or 'exterior deck screws 2.5 inch'. Send it for glue, finish and hardware so the live prices show the right product.",
"type": "string",
"maxLength": 80
},
"price_estimate": {
"description": "Your estimate in USD for one (for a tool, the tool)",
"type": "number",
"minimum": 0,
"maximum": 10000
}
},
"required": [
"name",
"kind",
"qty"
]
}
},
"quantities": {
"description": "Materials bought by area, volume or count: paint, stain, tile, flooring, fabric, soil, mulch, gravel, concrete",
"maxItems": 40,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "e.g. 'Exterior paint', 'Potting soil', 'Concrete mix', 'Floor tile'"
},
"form": {
"type": "string",
"enum": [
"area",
"volume",
"count"
]
},
"dims": {
"description": "Inches: [length, width] for area, [length, width, depth] for volume",
"minItems": 2,
"maxItems": 3,
"type": "array",
"items": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100000
}
},
"amount": {
"description": "Square feet, cubic feet or pieces, when dims don't fit",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000
},
"times": {
"description": "Repeat the dims, e.g. 2 coats or 4 walls",
"type": "integer",
"minimum": 1,
"maximum": 1000
},
"per_unit": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000,
"description": "What one unit covers (sq ft, cu ft or pieces), e.g. 350 for a gallon of paint, 0.6 for an 80 lb concrete bag"
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "e.g. 'gallon', '80 lb bag', 'box'"
},
"waste_pct": {
"description": "Extra to buy; default 10 for area, 5 for volume, 0 for count",
"type": "number",
"minimum": 0,
"maximum": 100
},
"price_estimate": {
"description": "Your estimate in USD for one unit",
"type": "number",
"minimum": 0,
"maximum": 10000
}
},
"required": [
"name",
"form",
"per_unit",
"unit"
]
}
},
"steps": {
"description": "Assembly steps in order; pieces refer to them with 'step'",
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 300
}
},
"units": {
"description": "Units for the reply text; imperial (inches) if left out. The plan page has its own switch.",
"type": "string",
"enum": [
"imperial",
"metric"
]
},
"kerf": {
"description": "Saw blade width in inches; if left out, divux assumes 1/8 inch and says so under Assumed",
"type": "number",
"minimum": 0,
"maximum": 0.5
}
},
"required": [
"title"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}