Free tool
Mosaic crochet designer
Pick a Moroccan zellige motif, or paint your own picture. The chart you see is calculated, live: our solver finds the overlay mosaic chart that is closest to your picture and still obeys every rule of the technique, then checks it again, stitch by stitch.
Motif
Size
Colour A (odd rows)
Colour B (even rows)
Keys: ← → stitch, ↑ ↓ row, Space play. Tap a stitch on the chart to jump to it. Your place is remembered in this browser.
Paint on "Your picture": the chart is solved again at every stroke. Digital preview drawn from the chart, checked by software; not crocheted.
Written rows (every row, right side, right to left)
From your own picture, and three more techniques
Upload any picture (it never leaves your browser), start from a random symmetric design, or paint on a blank grid, and get a chart that obeys every rule of the technique: overlay mosaic, tapestry crochet in up to eight colours, filet crochet (blocks and spaces, with an option that keeps every opening wide enough to cast light when a panel hangs in the sun), or a shape in the round (flat circle, cone, ball, hyperbolic ruffle) with its stitch counts calculated from its curvature. Each chart is checked by code, the written pattern is parsed back and compared with it, and you can see the fabric draped in 3D on a sofa, on a table or hung in the sun.
The workbench needs JavaScript.
Digital previews drawn from the chart, not photos of crochet. Gauges are assumed: measure a swatch.
How the chart is calculated
Overlay mosaic crochet looks free, but it follows strict rules. Every row is worked in one colour, on the right side; colours alternate (A on odd rows, B on even rows). There are only two stitches: a single crochet in the back loop, and a mosaic double crochet (the X on a chart) worked into the front loop two rows below, which stands in front of the stitch of the row below and hides it. That gives one exact equation for what you will see:
shown(row r, stitch c) = colour of row r+1, if row r+1 has an X at stitch c
= colour of row r, otherwise
So a stitch can show the "other" colour only if the row above drops an X in front of it, and an X can never sit on an X (its front loop is hidden behind the lower one). Not every picture can be crocheted: a lone cell of the wrong colour, or a shape whose edge falls on the wrong row, is impossible.
- The picture is drawn from exact geometry by our own code: eight-point stars, octagons and lozenges as inequalities, sampled once per pair of rows, because mosaic shows colour in pairs of rows. Or you paint it.
- The solver treats each column as a chain of yes/no choices (an X here or not) under one rule, and finds the chart that changes the fewest possible cells of your picture, by dynamic programming. It's an exact optimum, not a guess: for every motif here, at most 15 % of the cells move, each by one row.
- The checker then re-derives every rule from the finished chart alone, without the solver: no X on rows 1–2 or on the edge stitches, no X on an X, and every cell equal to what its stitches give. The written rows are generated from the same chart.
The same mathematics runs our printed patterns. It's tested: the solver in this page and the one that makes our PDFs give the very same chart, cell for cell, on every motif and on random pictures, and on small grids it's checked against every possible chart.
What maths can't promise: your tension. The size assumes 16 stitches × 19 rows = 10 cm in worsted; crochet a small swatch and measure your own. Nothing on this page has been crocheted: the fabric view is a digital preview drawn from the chart.
How to crochet the chart
Chain the width of the chart plus one, and work row 1 in A and row 2 in B in plain single crochet. From row 3, read each row of the chart from right to left with the right side facing you: an empty square is a single crochet in the back loop; an X is a mosaic double crochet in the front loop of the stitch two rows below (skip the stitch behind it). The first and last stitch of every row are single crochets through both loops. Fasten off at the end of each row and start the next row on the right again: the tails make a fringe, or hide them in a seam.
The same solver and checker made our mosaic crochet patterns, with colour and symbol charts, every row written out and materials: the Fez Star Cushion, the Star and Cross Blanket Square, and three throws in one piece: Fez Star, Star and Cross and Zellige Medallion. All our crochet patterns. Crochet with us: the free Ramadan crochet-along, a mosaic prayer mat, one square a week. More free tools: the bracelet designer · the zellige star designer.
Buy a full mosaic pattern here
Colour and symbol charts, every row written out, materials and finishing: PDF, instant download. Previews are digital; the charts are checked by software, not yet crocheted by us.