From a list to a printed page
Type the words once. Puzzleloom shows the actual page, the same layout that goes into the PDF, so you can check it before you print. Put the answer key at the back of the file, in a second file, or leave it out.
Why Puzzleloom
- Every word is placed, or you're told why. The crossword engine tries many layouts and keeps the most compact connected grid. If a word can't join it, you see which word and why. Nothing is dropped silently.
- One list, four puzzles. The crossword, word search, scramble and cryptogram tabs read the same list, so switching type never means retyping.
- A class set in one file. Up to 40 different layouts of the same words, each with its own printed ID and its own key.
- No ads, no account, no upload. It's a static site. Your words stay in your browser.
- Agents can run it too. The same engine runs as a CLI with clean JSON and as a local MCP server. Your assistant writes the clues; Puzzleloom lays out the grid and checks the key.
- Free. MIT licensed, with no locked features and no watermark.
Features
Make a puzzle
- Type one word per line. Add a clue after a colon, a tab or a spaced dash (
GARDEN: A place to grow). Import .txt, CSV or TSV. Up to 40 words.
- Your list is cleaned up as you type: characters removed from a word (
H2O becomes HO), lines without letters and duplicates are listed under "Changes to your list" instead of disappearing.
- Crossword: one connected grid with standard across and down numbering and no stray adjacent letters.
- Word search: each word appears exactly once. Easy runs across and down, medium adds diagonals, hard uses all eight directions. The fill never spells a word from a built-in blocklist.
- Word scramble: the same letters in a different order, never equal to the word. Hints can be none, the first letter or the clue.
- Cryptogram: a letter-substitution cipher of a quote or sentence you type, or one of the sample quotes. No letter maps to itself, and spaces and punctuation stay. Optionally show some given letters.
- Reshuffle for a new layout. Every puzzle has a seed and a short printed ID, and the same words, options and seed always give the same layout.
- Edit the title, the instructions and the Name, Date and Class fields.
Language and fonts
- Seven alphabets: English, Spanish, French, German, Portuguese, Italian and Dutch. Accented letters are kept, with options to strip accents or expand ß to SS.
- Print in Atkinson Hyperlegible or the OpenDyslexic font. OpenDyslexic is offered as a choice; Puzzleloom makes no claim that it improves reading.
- Text size S, M, L or XL for large-print sheets. Long clues and quotes paginate rather than being clipped.
- Light and dark themes, and a layout that works on a phone.
Print and export
- Vector PDF in black on white, with the fonts embedded, in US Letter or A4. The preview and the PDF come from the same page layout.
- Answer key at the back of the PDF, as a separate file, or left out.
- Class sets: 1 to 40 versions in one PDF. Each has a different arrangement of the same words, its own printed ID and its own key at the back.
- Export a page as SVG or PNG. The CLI can also combine several puzzles into one book PDF.
Save and share
- Save keeps a puzzle in this browser's IndexedDB under "My puzzles". Open, duplicate and delete them there.
- Export a
.puzzleloom.json project file to back a puzzle up or move it to another device. The format is puzzleloom.puzzle/v1, with a published JSON Schema.
- Play links put the whole puzzle in the part of the URL after
#, so nothing is uploaded. The player works in a phone or laptop browser: type into the crossword, drag across words in the search, check your answers and open the puzzle in the maker. A play link contains the answers, so it suits practice, not a graded test. You can switch off Reveal in the link.
For agents
puzzleloom CLI: make, render, check, link, book and mcp. With --json, stdout is exactly one JSON document and exit codes are stable.- A local stdio MCP server with seven tools:
create_puzzle, validate_puzzle, render_pdf, render_image, make_play_link, make_book and list_options.
- Same input, same output: the same words, options and seed give the same layout and the same PDF bytes. The details are in AGENTS.md.
Privacy
Puzzleloom is a set of static files with no server behind them. Once the page has loaded it makes no network requests: no analytics, no ads, no fonts from a font service and no third-party scripts. Puzzles, PDFs and saved projects are made in your browser. Saved puzzles live in your browser's IndexedDB on your device only, so clearing site data removes them. Download a project file if you want a backup.
A play link carries the puzzle and its answers in the URL fragment, which browsers don't send when they load a page. Anyone who has the link can read it.
The CLI and MCP server run on your machine and make no network calls either. There are no API keys, no accounts and no built-in language model.
How the layout guarantee works
A crossword is the hard one, and the claim is narrower than "always works".
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
