How to add a new puzzle

1. Create your puzzle

Go to /puzzles/new and use the editor to design your puzzle. Click a cell to select it, then use the toolbar buttons or keyboard shortcuts to place walls, pieces, and the destination.

You can use the Generate button to auto-generate a board, then tweak it by hand.

You can also go to an existing puzzle and click Remix to use it as a starting point.

There is a Preview button in the editor that you can use to test your puzzle.

2. Download the puzzle

Once you're happy with your puzzle, click Download in the editor panel.
This saves the puzzle as a .md file ready to be added to the repo. You can also use Import to load it back into the editor later.

3a. Submit a pull request

1. Go to the GitHub repository
2. Fork the repo (more on this here)
3. Create a new file at static/puzzles/your-slug.md and paste the copied markdown
4. Open a pull request, and I'll test, assign difficulty and merge your puzzles in

You can also follow the directions from the github README.md on how to run the app locally — this will let you save them directly to your machine

3b. Send me an email

If you know me — just send me puzzles on email, and I'll add them 😊

If you don't know me yet, reach out on LinkedIn