DEV Community

Joan Alba Maldonado
Joan Alba Maldonado

Posted on • Originally published at on

Yasminoku – Sudoku game, generator and solver in JavaScript (July 2006)

“Yasminoku” is an open source Sudoku (game, generator and solver) totally written in DHTML (HTML, CSS and JavaScript).


It is my fifth DHTML game and was made in mid 2006.

The game will generate sudokus and the player will have to solve them. But it is not only a normal sudoku game but also a sudoku solver, allowing users to introduce their own sudoku in order to solve it.

You can also change the game behaviour easily by editing many of the configuration variables which are at the beginning of the script.

This game doesn’t use any image at all, just pure HTML and CSS.

The game has been quite successful and famous, included for instance in a famous Spanish online newspaper called “Libertad Digital”.

Official languages are Spanish and English. You can find a lot of translations in other languages over the Internet, including German, French, Portuguese, Czech, Hungarian and Chinese.

Other modified and adapted versions of this game can be found on the Internet, including one Opera widget and several translations.

This game has been tested under BeOS, Linux, NetBSD, OpenBSD, FreeBSD, Windows, Mac OS X, BlackBerry Tablet OS, Android, iOS and others.

UPDATE (9th December 2014):

The new improved version (0.75a) comes with some bug fixes, using some CSS3 effects and HTML5, a better mobile devices support, autosave (using Web Storage and falling back to cookies if not supported), it is printer-friendly, it adapts automatically to any screen resolution (200 x 180 is the minimum), improves browser integration (can be included easily in any web site with an IFRAME, for example), is available for and ported to many platforms and can be ported to many more (it is compatible with Apache Cordova, PhoneGap Build, PhoneGap, Intel XDK, BlackBerry WebWorks, virtually any browser extension guidelines and so on), and is now multilingual with language auto-detection (main version includes Chinese, English, Catalan and Spanish languages and it is very easy to add new ones).

It can be controlled by mouse (or finger on mobile devices) and/or keyboard (gamepads on some devices as Wii or some remote control on some TV devices should also work).

Through the new configuration menu, you can choose language (in the case you are not happy with the auto-detected one), disable autosave, change the way the game helps you, set the number of seconds the on-the-fly calculated solution is displayed and disable some visual effects (in order to improve performance).

The game is specially designed to allow to be used inside any other web site (by using an IFRAME, for example). We just need to get the URL (which will be used in the SRC parameter of the IFRAME tag) generated by the “Share” option (inside the configuration menu). If we want to configure it even more, we can set or edit some parameters included in the generated URL (you can read more about it in the game’s website). You could even use another sudoku generator and send the generated sudoku to the game through a parameter of its URL.

Since you can choose the initial numbers, from 0 to 81, keep in mind that sometimes the game can generate sudokus with more than one solution.

Native ports that have been tested should work properly. Browser version will work virtually everywhere, in modern browsers as well as in old ones (including Internet Explorer 5.0).

Apart from the normal version (for web browsers), some ports and versions include Android (including Nokia X and Fire OS which is used by Amazon Kindle Fire, Amazon Fire TV, Amazon Fire TV, Fire Phone, etc.), iOS (iPhone, iPod Touch, iPad), BlackBerry 10, BlackBerry Tablet OS (BlackBerry PlayBook), Nokia Series 40 (S40) / WRT Widget, Nokia Asha widget / W3C Packaged Web App (W3C Widget), Windows Phone 7 & 8, Chrome OS / Chromium OS (Google Chrome App), Firefox OS (Mozilla Firefox App), Mozilla Firefox Add-on, Opera Extension (Opera add-on), Google Chrome extension, Safari extension, Microsoft Edge extension, WebOS, Facebook App, Windows 32 bit (including installer), Apple Mac OS X (Intel), Linux x86 (32 bit and 64 bit), Raspberry Pi and compatible (Linux as Raspbian or Pidora), etc.

To read more about how to use it in your web site, port it to other platforms, translate it to other languages, etc. please, refer to its official site below.

Play online in multiple languages:

Play online in multiple languages (mirror):

Official web site: (mirror at

The repository can be found on GitHub:

Top comments (4)

ianandhum profile image
Anandhu Manoj • Edited

Great Work! UX is amazing and I love the flat layout though(I just saw it in the settings of your game)

jalbam profile image
Joan Alba Maldonado

Thank you very much! Yes, in the settings you can tweak appearance and improve performance for slow systems (as for Raspberry Pi 1, for example).

awwsmm profile image
Andrew (he/him)

Looks great!

jalbam profile image
Joan Alba Maldonado

Thank you very much!