How It Works

The engineering behind a personalized crossword constructor.

Freeform Strategies

When you generate a crossword, you can pick from three different placement strategies. Each one orders your words differently before handing them to the greedy placer, producing layouts with different characteristics.

The Block Builder

Work in Progress

The Block Builder produces newspaper-style grids with dense black squares and dictionary fill. It runs in three phases: scaffold the user's words via the freeform solver, carve out a structured grid by progressively marking cells black, then fill every remaining slot with a real dictionary word.

The walkthrough below shows the distinguishing move: the shrink-and-carve structure phase, where an open canvas is shaped into a proper crossword grid before any fill happens.

1. Place the user's words

1 / 6
T
C
I
O
D
R
E
E
F
A
L

Phase 1 hands the user's three words (CORAL, TIDE, REEF) to the freeform scaffold solver. The solver lays them out so they intersect: REEF crosses CORAL at R and crosses TIDE at E. CORAL's O sits right beside TIDE's D at row 3, which means the algorithm gets an OD across word for free without ever placing it. Every other cell is open canvas, waiting to be carved or filled.

User wordJust placedDictionary fillOpen candidateCarved black
User word: CORAL

The Guided Builder

Freeform mode builds the grid around your words. The Guided Builder works the opposite way: you start with a fixed grid pattern (5×5, 7×7, or 15×15), and the engine helps you place words slot by slot. It's the right tool when you want a traditional NYT-style crossword shape.

Two-Layer Word Source

Your themed words are prioritized because they're the answers you care about. A built-in 42K-word crossword dictionary (Collaborative Word List, MIT-licensed) handles the structural fill.

Real-Time Constraint Propagation

Click any slot to see every word that could fit, given the letters already placed at crossing points. Pick one, and all intersecting slots update instantly using AC-3 arc consistency.

Editable Grid Pattern

Toggle any cell black or white to shape the grid. Optional 180° rotational symmetry mimics the standard NYT layout, or turn it off for fully custom shapes.

Auto-Fill the Remainder

Place a few key answers manually, then let the CSP solver fill the rest. The solver prioritizes your themed words and uses the dictionary for the structural fill.

Open the Guided Builder →