iPuzzler is a tool for publishing crossword puzzles on the web. It takes puzzles published in the iPuz format and renders them as playable puzzle grids that you can embed in any web page.
Demo
Example Usage
<html>
<head>
<title>iPuzzler Demo</title>
<script type="module" src="js/ipuzzler-1.0.0.js"></script>
</head>
<body>
<ipuzzler-puzzle src="puzzle.ipuz"></ipuzzler-puzzle>
</body>
</html>
Getting Started
iPuzzler is distributed as a single standalone JavaScript module. It requires no libraries, frameworks or external CSS.
- Download ipuzzler.js - the current release is 1.0.0.
- Save it somewhere in your website. These instructions assume you’ve saved it into
/js/. - Add
<script type="module" src="/js/ipuzzler-1.0.0.js"></script>to the<head>of your page. - Publish your crossword puzzle in iPuz format
- Add
<ipuzzler-puzzle src="my-puzzle.ipuz"></ipuzzler-puzzle>to your page.
That’s it.
Submitting Answers
If you add a submitUrl attribute to the HTML tag, iPuzzler will add a Submit Answers button, that will submit your solution as an HTTP post to the specified URL.
<ipuzzler-puzzle src="my-puzzle.ipuz" submitUrl="https://example.com/puzzle/submit"></ipuzzler-puzzle>
Example Puzzles
I created iPuzzler after I created a special crossword to commemorate the US 2020 election, and then discovered there was no way to publish it online. That puzzle is a little bit special - same grid, same clues, but it has two valid solutions, and at the time of publishing, we didn’t know yet which one was correct:
- Dylan Beattie’s Election 2020 Crossword: TRUMP version / BIDEN version
(The solution and explanation is available online)
- CityJS 2021 Crossword Puzzle - a puzzle I created to accompany a talk about iPuzzler presented at CityJS online in March 2021.
Crossword Compiler ships with several sample puzzles, that have exported in iPuz format to demonstrate iPuzzler:
A couple of newspaper puzzles I’ve converted to iPuz format:
- The Guardian Cryptic no 28283, set by Boatman
- The Guardian Prize no 22089, set by Araucaria