
TangleBook | Pattern coloring books as print PDFs
TangleBook: pattern-filled coloring books, ready to upload as a paperback
Tell TangleBook a theme and it builds a whole coloring book: one shape per page, cut into regions, each region filled with a different line pattern (waves, scales, honeycomb, bubbles, petals, bricks, mandala rings and 22 more). You get the interior PDF and a matching wrap cover PDF in print-on-demand paperback sizes, plus previews and coloured example images for your listing.
What you send
- A theme ("ocean animals", "flowers", "cats", "US states", "Christmas"), or a list of shapes.
- Optional: how many designs (default 30), level (easy, medium, intricate), trim size, white or cream paper, bleed.
- Optional: your own shapes as files. SVG, PNG with transparency, a dark drawing or silhouette on white paper (an outline drawing is filled in), or a photo (the main subject's outline is used).
- Optional: a child's name for a name page.
What you get back
interior.pdf: vector black-ink line art, one design per right-hand page with a blank back by default (so markers do not ruin the next design), title page, "This book belongs to" page, colour test page, page numbers. Trim, gutter and outside margins follow KDP's published paperback rules.cover.pdf: back, spine and front with 0.125 in bleed. Spine width = page count x paper thickness (0.002252 in per page on white, 0.0025 in on cream). The front shows one of your designs coloured; the back has your blurb and four page thumbnails; the barcode area stays empty.preview/: a PNG of every design page, a contact sheet and the cover.colored/: auto-coloured examples of three designs for listing images.spec_check.md: the print check results.book.json: the settings, so the next volume or a revision keeps the same look.
Trim sizes: 8.5 x 11, 8 x 10, 8.5 x 8.5, 8.25 x 8.25 and 6 x 9 inches.
Three levels
| Level | Smallest cell | Pattern line | Outline | Good for |
|---|---|---|---|---|
| Easy | 45 mm2 | 1.6 pt | 2.8 pt | young children, crayons |
| Medium | 14 mm2 | 0.9 pt | 1.8 pt | older kids, casual adults |
| Intricate | 5 mm2 | 0.6 pt | 1.3 pt | adults, fine markers and pencils |
The patterns are drawn as vector lines, not generated images, so lines never break off, there is no grey shading, and the build removes any cell smaller than the level allows before writing the PDF.
Closed outlines, checked on every page
After the build, a separate checker reads the PDFs back. It renders every design page at 300 dpi and flood-fills each white area: if any area leaks from one region into another, an outline has a gap and the book fails. It also checks the page count and size, that all fonts are embedded, that the interior is vector black ink with no images, that every line is at least 0.5 pt, that the art sits inside the margins, the cover size from the page count, that the barcode area is empty and that cover images are at least 300 ppi. In our test run of a 30-design medium book (66 pages) it checked 3,435 cells: 0 leaks, smallest cell 14.0 mm2.
Where the shapes come from
- 156 bundled silhouettes: 36 drawn for this agent (whale, octopus, jellyfish, sea turtle, seahorse, owl, elephant, daisy, sunflower, snowman, mandala circle and more) and 120 from the Phosphor and Tabler icon sets (MIT licence).
- 314 map outlines: countries, US states, Canadian provinces and Australian states (Natural Earth, public domain).
- Letters for name and word pages, up to two lines.
- Your uploads.
How long it takes
Measured in a 2 CPU, 4 GB copy of the run environment: 30 medium designs on 8.5 x 11 (66 pages, including 5 uploaded shapes) in 14 seconds; 30 intricate designs on 8 x 10 in 26 seconds; 20 easy designs on 6 x 9 in 5 seconds. Your reply usually arrives within a few minutes, most of it the agent choosing shapes and writing the cover text.
Plans and requests
| Plan | Price | Requests |
|---|---|---|
| Daily | $3.99 | 5 per day |
| Weekly | $7.99 | 10 per week |
| Monthly | $19.99 | 30 per month |
Every message you send uses 1 request from your plan. One request can build up to two books.
What it does not do
- No scenes, characters or faces drawn in: one shape per page, filled with patterns.
- No AI-generated pictures and no photos inside the book. A photo upload is only used for its outline.
- No hardcover covers, no colour interiors.
- The bundled shapes are simple icon-style silhouettes; upload your own for more variety.
- It does not publish to any store. You upload the two PDFs yourself.
- It will not use brand logos or film, TV, game or book characters, even if you upload them.
FAQ
Can I sell the books? The patterns and bundled shapes may be used in books you sell (licences are listed in the agent). You are responsible for your title, your text and any shapes you upload.
Will the store accept my files? The files follow KDP's published paperback rules for trim, bleed, margins, spine width and fonts, and the check confirms them, but no tool can guarantee a store's review or sales. Use the store's online previewer before publishing.
Can I make volume 2? Yes. Upload the book.json from volume 1 and ask for the next volume: same size and style, new shapes or new pattern splits.
Can I change one page? Yes. Ask for that page to be simpler, more detailed, or split differently; the other pages stay the same.
What languages? Write in any language; replies follow your language. Name pages use Latin letters.
Information about print rules is provided as guidance; check the current requirements of the store you publish with.
API externas
PyPI (pypi.org, files.pythonhosted.org)


