Crossingword

Crossingword is your puzzle workshop in a browser: add words you love, press generate, and a clean crossword appears in seconds.

🧊 Quickest Way In (Docker)

Prefer not to install anything? Pull the prebuilt image and launch Crossingword instantly:

docker pull ghcr.io/dbccccccc/crossingword:latest
docker run --rm -p 8080:80 ghcr.io/dbccccccc/crossingword:latest

Then visit http://localhost:8080 in your browser. Crossingword stores your word list locally, so feel free to close and reopen the tab whenever you like.

🙋 First Puzzle in Five Steps

1. Add a word – type it in, click Lookup for an instant clue suggestion, and press Add Word.
2. Repeat – 5–10 words gives the generator plenty to work with.
3. Generate – hit the big Generate Crossword button and watch the grid appear.
4. Tweak – toggle solutions, zoom in/out, and read the automatically grouped Across/Down clues.
5. Rinse and repeat – edit your word list and generate again until it feels just right.

🧰 Handy Tips

• Use Load Sample Words to see a finished example.
• Hover over a word in the list to delete it.
• The lookup button can turn a dictionary definition into a clue with a single click.

📤 Share or Save

When you like the layout, open Export Crossword:

• PNG – best for handouts and slides.
• SVG – perfect for designers who need resolution-free art.
• JSON – keep a digital record you can re-import later.
• Flip the “Include solution” switch to choose answers-on or answers-off.

👩‍💻 Prefer Running Locally with npm?

git clone https://github.com/dbccccccc/crossingword.git
cd crossingword
npm install
npm run dev

Navigate to http://localhost:5173 and you’re ready to puzzle.

💬 Need a Hand?

We’re puzzle nerds too. Open an issue, suggest an idea, or share the crossword you built—can’t wait to see it.

Happy puzzling! 🧩